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Introducing ProtoGen+. Visual tools with the most awesome 
workbench ever created for Windows development. 


lie future has arrived—a complete 
point-and-click. WYSIWYG 
workbench that lets you create 
dazzling applications without 
writing a line of code. 


Discover the ease and 
productivity of visual 
development! 


Paint your 
screens. Design 
a menu and link 


screens togeth¬ 
er. Test the flow 
in a live environ¬ 
ment, and gen¬ 
erate code for 
ANSI C, C++ 
for OWL or MFC 
or Pascal with 
objects. It's that 
easy. 

And this 

open! ProtoGen+ 
will work with 
your database, 
compiler, 
libraries and extensions. Powerful 


Visually 

develop 

screens 



Create a menu 
and connect 
screens & dialogs 



Test the applica¬ 
tion's screen flow in 
a live environment 



Instantly generate 
source code in 
Pascal, C or C++ 


add-on features, like SQLView offer 
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Bring your applications to life using the latest 
visual design tools! 



workbench access to multiple 
databases to develop client/server and 
xBase applications. Snap-in compo¬ 
nents make ProtoGen+ open to future 
development technologies—whatever 
they may be. 

ProtoGen+ is easy to learn, 
speeds your development cycle and 
protects your investment by generat¬ 
ing C,C++ and Pascal. We guarantee 
you'll 
prototype 
and generate 
exciting 
applications 
faster than 


The most powerful, open set of 
Visual Development Tools ever! 
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Point-and-click to paint 
screens with bitmaps, 
icons, tables, data valida¬ 
tion. custom colors, fonts, 
3D effects, visual tool¬ 
bars, status lines, balloon 
help. MD1 and more! 


you ever 

thought 

possible! 
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The Visual Development Edge™ 

All products named are trademarks of their 
respective companies. ©1993 ProtoView Development 


Build win¬ 
dows, forms, 
dialog boxes, 
tool bars 

Output C. 
C++ and 
Pascal with 
Objects 

Create new 
designers! 
Source 
included 


Dialog 

Menu 

Editor 

Designer 

Code 

ProtoView 

Gener¬ 

Screen 

ator 

Manager 

Custom 

Win- 

Visual 

Control 

Designer 

Library 


Quickly 
create a 
menu using 
templates 

Data valida¬ 
tion, 3-D 
effects, MDI 
and more 

Rich library 
of visual 
control 
objects 




License our technology to 
create new code generators 


Fasten your seatbelt 
for ProtoGen-#-! 


Only 


(list price 
$395) 


$199 

1 - 800 - 231-8588 

Ask for Ext. 60 
In NJ, call (908) 329-8588 
ProtoGen+'s SQLView access to multiple 
databases is available at an additional price; 
ask about it when you call. 
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Take the direct path to ODBC with Q+E Software. 


Simplified and standardized database 
access... that’s the promise of ODBC. But 
you have to get there first. It’s easy to get lost 
in the search for reliable ODBC drivers. And 
trying to write ODBC-enabled applications 
without the proper tools can lead you straight 
into a dead end. 

Q+E Software puts an end to the frustra¬ 
tion and confusion. We’ll lead you through 
the maze of possibilities with a comprehen¬ 
sive solution for all your ODBC driver and 
development needs. With Q+E you can get 
what you need out of ODBC without getting 
lost in the process. 

Connect ODBC-compliant applications no 
matter what you find around the corner. 

With Q+E ODBC Pack, you can take 
advantage of the same database access tech¬ 
nology we provide for such leading software 
publishers as Lotus, Computer Associates, 
Sybase, INFORMIX, and PowerSoft. Q+E 
ODBC Pack offers a comprehensive suite 
of drivers for more than 30 SQL and PC 
DBMS versions. 

And, as new ODBC applications come out, 
Q+E Software will continue to take you 


where you need to go. Each of our drivers is 
fully supported and kept absolutely up-to-date 
by our technical support staff. 

Count on a robust ODBC development tool 
that removes the obstacles in your way. 

When it comes to making sure your appli¬ 
cations are ODBC-compliant, you can rely 
on the same technology that WordPerfect, 
Delrina Technology, Crystal Services, and 
dozens of other prominent software compa¬ 
nies use. Q+E Database Library gives you an 
easy way to build ODBC-enabled applica¬ 
tions—no matter what development environ¬ 
ment you prefer. 

You can forget about differences in drivers, 
because our development tools let you write 
code once that works with all major databases. 
And because Q+E Software keeps up with the 
constantly changing technology, you won’t be 
left on your own when custom applications 
need modification. 

Turn to Q+E Software for your total 
ODBC solution. 

Whether you’re looking for ODBC drivers 
or planning to build ODBC applications, 

Q+E Software offers the path that’s fast, easy, 


CL+E ODBC Pack and Q.+E Database Library provide dependable 
and complete support for the following databases: 

ALLBASE, Btrieve, Clipper, DB2, DB2/2, DB2/6000, dBASE, Excel .XLS files, FoxBase, FoxPro, Gupta 
SQLBase, IMAGE/SQL, INFORMIX, INGRES, Microsoft SQL Server, NetWare SQL, Oracle 6 and 7, 
Paradox, PROGRESS, SQL/400, SQL/DS, Sybase System 10, Sybase SQL Server, Teradata, Text files, and 
XDB. Gateways supported include IBM DDCS/2, Micro Decisionware, and Sybase NetGateway. 

Not alt DBMS are available on all platforms; some may require a gateway. Call for details. 


and direct. Our ODBC solution is multi¬ 
platform, with versions for Windows, OS/2, 
Macintosh, Windows NT, and Solaris. And 
we offer single-source technical support for 
more databases than anyone in the industry. 

When it comes to ODBC, Q+E Software 
gets you there now. No delays. No confusion. 
No walls. 


Find out more about 
Q+E Software today! 
Request a FREE copy of 
Qetting Connected — 
An ODBC Primer. 
Call 1'800-876-3101, 
ext. D030, 8 am to 8 pm EST. 



- Byte Magazine, 
March 1994 


Q.+E Software 

5540 Centerview Drive, Suite 324 • Raleigh, NC 27606 
800-876-3101, (919) 859-2220, Fax (919) 859-9334 
• Q+E Software Europe (31) 1022 02022; Fax (31) 1045 63348 • Q+E Software (Deutschland) GmbH, (49) 228 970760; Fax (49) 228 9707610 • Q+E Software (UK) Ltd., (44) 273 489 888; Fax (44) 273 486 224 
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A C++ Debugging Output Stream. 7 

In C under DOS, pri ntf () statements work fine to help debug your code. Under Windows, 
DebugOutput () can provide an acceptable substitute for pri ntf (). But what if you want to use 
C++’s typesafe I/O system instead? This article shows you how to combine templates with 
I/O streams to create your own output debugging stream for C++ Windows programs. 

John Gmutza 

Setting Breakpoints in a Windows NT Debugger. 13 

You won’t find Tool Help in Windows NT, but you will find a documented API that gives you 
everything you need to write a Windows NT debugger. This article describes the API and 
demonstrates how to use it to create a very simple debugger that lets you set breakpoints. 
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As expected, Software Development 1994 was a whirlwind of parties, programmers, and 
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Ron Burk 
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WinScope. 39 

Ever since the original Microsoft Spy program, which lets you spy on other applications’ 
window messages, programmers have been building bigger and better Spy utilities. Jeff 
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Practical C++: Dynamic Function Calls. 59 
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"Sourcer combined with Windows 
Source should be mandatory for 
looking into Windows Programs." 

Sal Ricciardi - PC Magazine 


Discover the secrets the insiders use 
with Windows Source! 

Learn the numerous undocumented 
functions used by the professionals to 
perform tricks that are otherwise im¬ 
possible! 

Windows Source™ generates detailed 
listings of Windows EXEs, DLLs, and 
VxDs. See the actual Windows func¬ 
tion names used within the programs. 

Windows Source includes the follow¬ 
ing special features: 

♦> Identifies all imported function 
calls, including Windows API calls. 
♦$» Labels all exports from an execu¬ 
table, DLL or device driver. 

♦> Includes Codeview symbols when 
available. 

Identifies, by name, the VxD API 
entry points and services provided. 

♦> Describes DPMI, DOScall and 
VMM interrupt subfunctions. 

There is no way to get better commented 
assembly source code from Windows 
programs. Bundled with Sourcer for 
DOS binary file disassembly. 

Just $229.95! 

Call 800-648-8266 
to order now! 

WML V Communications, Inc. 

'A 1^4320 Stevens Creek Blvd., Suite 275-WD 
4 / San Jose, CA 95129 FAX 408-296-4441 
408-296-4224 



From 

the Editor 


My dream of cheap symmetric multiprocessing machines driving NT sales 
is getting closer to reality. Intel has defined a specification for SMP machines 
and hardware vendors are jumping on it. ALR already advertises a four-proces¬ 
sor lOOMhz Pentium for $22K and some change. The heck with that, I bet I 
can buy a four-processor 66Mhz 80486 machine for $5K by the end of 1994 - 
why pay for a Pentium when half my CPUs will be I/O bound anyway? Since 
Cyrix won their legal wranglings with Intel, and since IBM signed an agreement 
to manufacture Cyrix chips, the price for a fast 80486 should tumble even 
faster than usual. 

The new version of Windows finally shipped! No, not Chicago, but Win¬ 
dows vB.11, a patch that you can get by downloading file ww0981.exe from 
forum MSL on CompuServe. Maybe palette animation will now work with my 
Tseng ET4000 SVGA chips. Maybe GDI won't get a divide-by-zero error when I 
set my PostScript scale to 10 percent. Maybe I should stop getting my hopes 
up. 

In other publications: Getting ready to build that million-dollar usability test¬ 
ing lab you've always wanted? Check out Marc Rettig's excellent Practical Pro¬ 
grammer column in the April 1994 Communications of the ACM, in which he 
extols the virtues of "lo-fi prototyping" - using tools like construction paper to 
quickly and cheaply test user interfaces. If you're gung-ho enough to be hand- 
optimizing assembly language for the Pentium, better get a copy of Michael 
Abrash's new book Zen of Code Optimization - he starts with the 8088 but 
almost a quarter of the book is devoted to the Pentium. If you're gung-ho 
enough to be writing VxDS, you may have to buy a copy of Writing Windows 
Virtual Device Drivers by David Thielen and Bryan Woodruff, but you probably 
won't be happy about it when you discover that the bulk of the book is 're¬ 
printed with permission of Microsoft Corporation." You've heard of the VxD-Lite 
Mini-DDK? Well, this is the Content-Lite Mini-DDK-book! I certainly have 
enough expensive VxD books that duplicate Microsoft's documentation - now 
won't someone do us all a favor and write a good VxD book? The one and 
only "industry newsletter' I read is Windows Watcher ($395 per year, 1 -800-223- 
8720). It often has the best handle on what Microsoft is really up to and just 
how late Chicago will really be; it usually has the best rumors and wickedest 
jokes (soon, you too will be calling Chicago 'Windows OT," for "Old Technol¬ 
ogy"). If that plug doesn't get me one of those simulated goldtone Windows 
Watches with imitation leatherette band, I don't know what will. Now if I could 
just figure out how many employees I have to claim in order to get a free 
subscription to PC Week. 

Ron Burk 

Editor 

CIS: 70302,2566 ; Internet: ronb@rdpub.com (“...iuunetirdpubironb") 
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Finally, 
a sophisticated 


Windows testing tool 
that's easy to use! 



Point-and-click interlace 
with customizable toolbar: 

every feature you need is 
immediately accessible. 


Document your scripts 
and log files: see exactly 
what's happening 
through each step of 
your tests. _ _ 

Compare images ^ 


Compare window 
internal details 


Detailed log file: see the 

complete results of every 
test you make. 


Interactive Suite Manager: 

combine test scripts into 
suites at the touch of a 
button. 


Testing is automatic: run 

single or multiple scripts. 

Set up multiple loops 
without programming or 
modifying your scripts. 


Use "drag-and drop" to 
quickly create the precise 
test orders and hierarchies 
you want. 


Vermont HighTesf 


T esting is essential, and so is your sanity. 

Now there's a way to keep both. Vermont 
HighTest is a new kind of testing tool for 
Windows™ developers: it's sophisticated, flex¬ 
ible, and powerful — yet actually easy to use! 

With HighTest, you can create test scripts simply 
by running your application. An interactive Suite 
Manager lets you easily create, modify, combine, 
and run test suites — all with a few quick clicks 
of your mouse. The best thing about using 
HighTest's Suite Manager is you can do it all with 
no programming! 


variables, manipulate files, program loops, perform 
conditional branching, and much more. You don't need 
to buy Visual Basic or be a programmer. 

Vermont HighTest is loaded with support features that 
will make your testing and reporting job easier, includ¬ 
ing our interactive suite manager, a built-in debugger, 
and an automatic log file of testing actions and results. 

Call today for your free demo and find out how Vermont 
HighTest can save your reputation and your sanity. You’ll 
do better testing in less time, with less effort, and for less 
money. 


Of course, for full flexibility, you'll have access 
to our powerful and easy-to-use testing control 
language. You'll find it a snap to define and access 



Vermont Creative Software 


1 Pinnacle Meadows Richford, VT 05476 #538 

International 1-802-848-7731 Fax 1-802-848-3502 


Call 1-800-848-1248 for a free demo of Vermont HighTest. 
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applications on Windows™, Windows Solutions is for you. Windows Solutions is the only event where 
you will get all the information you need and see all the products required to make you more successful. 


3-DAY CONFERENCE 

Over 60 informative sessions 
covering solutions-oriented 
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September 7-9,1994 
San Francisco, 
Moscone Center 


Windows 


Solutions 
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CALL NOW 

for your free 

Windows Solutions event brochure 



3-DAY EXPOSITION 

Over 250 exhibits by leading- 
edge Windows-based hardware 
and software manufacturers. Expect 
major new product announcements. 
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Debugging 


A C++ Debugging Output 
Stream 

John Gmutza 


ok-ok-ok- 



Debugging has come a long way since the good old days of DOS DEBUG. 
We now have sophisticated source-level debuggers and hardware support for 
debugging. Add to that the sophisticated interfaces possible with GUIs, and you 
can quickly become overwhelmed. As always, however, technology does not 
advance without cost. One disadvantage of Windows is that you can no longer 
quickly insert calls to printfO to help debug your code. For many situations, 
such as debugging a small section of code, cranking up all the debugger over¬ 
head (recompiling, etc.) isn't worth it when you've got trusty printfO for diag¬ 
nostic output. This article describes a Borland C++ class I've implemented that 
creates a C++-style output stream for debugging output. 

Introduction 

When moving from DOS to Windows, some developers look for a diagnostic 
output corresponding to the beloved printfO. These developers typically end 
up using MessageBoxO. Unfortunately, MessageBoxO does not offer the text for¬ 
matting abilities of printfO. Also, it interferes with your user interface, since 
you have to press the OK button to dismiss the message window after each 
message. That means it also does not help in solving problems that are timing- 
related, and it can't be used in many situations, e.g., debugging mouse events. 
Ironically, debuggers can often interfere in these same situations. 


John Gmutza has a BSCS degree from Western Michigan University and is currently 
head of Research and Development at Postek, Inc., a Troy, Mi-based software com¬ 
pany that markets Caller-ID database software. He has been writing Windows applica¬ 
tions for five years and using C++for the last two of those years. All of his develop¬ 
ment is now done in C++, primarily with Borland development tools. His computing 
experience, which stretches back to writing BASIC programs on timeshare systems in 
the eighth grade, also includes five years of writing UNIX applications. 


June 1994 


Windows/DOS Developer’s Journal — Page 7 





















Listing 1 odsl.h — First version of debugging output stream 

#ifndef ODS H 


((define ODSJ 

// manipulator to trigger debug output via 

// ods 

// OutputDebugStringO 

// Output Debug Stream 

ostreamS dumpiostream &os) { 

// John Gmutza, Postek Inc. 

ostrstream &oss = (ostrstream &)os; 

#1fndef IOMANIP H 

// null-terminate current data 

#include <iomanip.h> 

oss « ends; 

(fendi f 

// get the string 

#ifndef STRSTREAM H 

char *buf = oss.strO; 

((include <str$trea.h> 

// output string to debugger 

(fend if 

OutputDebugString(buf); 


// unfreeze and reset streambuf 

tempiate<int SIZ = 256> class ODS: public ostrstream { 

oss.rdbuf()->freeze(0); 

public: 

oss.rdbuf( ) ->seekpos(0); 

ODSO :ostrstream(buf, sizeof buf) { *buf = * \0 ’ ; } 

return os; 


} /* dump */ 

protected: 

#endif 

char buf[SIZ]; // the output buffer 

}; 

/* End of File */ 


Windows 3.1 provides some relief. The ToolHelp DLL 
offers a function named OutputDebugStringO. Calling this 
function triggers a ToolHelp notification that a separate 
task can receive and use to display the debugging string. 
For example, Microsoft's DBWIN displays the strings sent 
to OutputDebugStringO. Borland C++ v4.0 includes a similar 
utility, and Turbo Debugger for Windows automatically 
displays such output in a log window. 

That still leaves the problem that OutputDebugStringO 
accepts a single string and does not supply the output for- 


“One line of code... 
One click...” 
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free tech support, royalty-free 
runtime, 30 day money back guarantee 



MediaDeveloper™ 2.0 

MULTIMEDIA APPLICATION BUILDER FDR WINDOWS & NT 
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El SYSTEMS ■ INTERNAL 


IENEL SYSTEMS ■ INTERNATIONAL INC. 
290 Woodcliff Office Park 
Fairport, NY 14450-4212 

Fax (716) 248-9185 
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TODAY! 

1-800-22 LENEL 

(5 3 6 3 5) 
COMPUSERVE 71333.622 
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matting capabilities of printfO. Fortunately, C++ comes 
with its own typesafe I/O facility that is designed to be 
extensible. I will show how you can extend C++ output streams 
to handle Windows debugging output in a natural way. 

C++ Streams 

As with C, I/O in C++ is supplied in the form of a li¬ 
brary, not as part of the language syntax itself (see any 
good book on C++ for a description of C++ streams). The 
advantage of the C++ style of I/O is that it is offers type 
checking, using overloaded operators (« and »). For ex¬ 
ample, in C you might write: 

FILE ‘Output; 
int x=3,y=6; 
char c=’C'; 

/*...*/ 

printfCx = %d y = %d c = %c\n", 
x, y, c); 

whereas an equivalent output statement in C++ might 
look like this: 

ostream Output; 
int x=3,y=6; 
char c=’C'; 

II... 

Output « "x = " « x 
« "y = " « y 
« "c = ” « c 
« ’An”; 

Customizing an Output Stream 

The source or destination of stream I/O can be a de¬ 
vice, file, or memory. This is achieved through inheritance. 
Of particular interest to this article are classes based on 
strstream, a memory-based stream. Derivatives of 
strstream use a char array as the source or destination of 
data. My first attempt at creating this class involved inher¬ 
iting from ostrstream This implementation worked, but left 
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some "unclean' details, which plagued my conscience. The 
result is shown in odsl.h (Listing 1). 

In odsl.h, ODS is a template class. The template parame¬ 
ter is the size of the output buffer. If you don't need this 
complexity, you can remove it. You are then faced with 
determining a 'reasonable' buffer size, something big 
enough to handle all anticipated debugging output mes¬ 
sages. 

ODS is derived from class ostrstream. The constructor 
initializes the ostrstream to use the buffer ODS defines as its 
output destination. An ostream manipulator (a function that 
produces a side effect, rather than output text), dump, calls 
OutputDebugStringO with the current value of the buffer. 
dump resets the buffer to the null string afterward. This al¬ 
lows concatenation of multiple out¬ 
puts before sending the string. Within 
dump, I use some casting trickery to 
gain access to certain protected 
members of ostrstream. 

However, this implementation left 
me with the following specter: I really 
wanted to use the standard ostream 
flush manipulator to send output to 
OutputDebugStringO, instead of the 
kludgy dump manipulator. Also, other ma¬ 
nipulators I may write would most likely 
contain the same cast used in 


Listing 2 ods.h ■ 
C++ and Windows 


A debugging output stream for 


fifndef ODS H 
#define 0DS_H 
// ods 

// Output Debug Stream 
// John Gmutza, Postek Inc. 

// Use freely, but please credit author! 

#ifndef _I0MANIP_H 

include <iomanip.h> 
fendi f 

fifndef _STRSTREAM_H 
include <strstrea.h> 
fendif 

class debugstreambuf: public strstreambuf { 
public: 


A Better Version 

Clearing my programming con¬ 
science would require more digging 
into the stream I/O class hierarchy. 
Fortunately, I didn't have to dig too 
deeply. The "correct' place to trigger 
OutputDebugStringO is in the virtual 
syncO function of strstreambuf de¬ 
rived classes. To do this, I needed my 
own derived class. To use this class, I 
mirrored the construction of the 
ostrstream class, using my derived 
classes debugstreambuf and debug- 
streambase. With cleared conscience, I 
present the second version of class 
ODS, in ods.h (Listing 2). 

The new version is similar to the 
first, but it uses the normal flush ma¬ 
nipulator instead of dump. All is ar¬ 
ranged properly for the standard os¬ 
tream machinery to trigger the output. 
The sync member is defined inline. This 
avoids multiple definition errors when 
you include ods.h in multiple modules. 
Additional manipulators and flags can 
be added, to enhance debug function¬ 
ality. Use your imagination. 

Better Than printfO? 

Once I finished class ODS, I never 
looked back. ODS can be used as the 
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Listing 2 continued 


debugstreambuf(char *buf, sizet siz, char *st) :strstreambuf(buf, siz, st) {}; 
debugstreambuft) :strstreanbuf() { }; 

int syncO { 

int ret = strstreambuf::sync(); 

// null-terminate 
sputcC'\0‘): 

// output string to debugger 
char *buf = str(); 

OutputDebugString(buf); 

// reset string 

seekoff(0, ios::beg, ios::out): 
return ret; 

) /* sync */ 


class debugstreambase: public virtual ios { 
public; 

strstreambuf _FAR * _Cdecl rdbufO { return (strstreambuf _FAR *)&this->buf: } 
protected; 


_Cdecl debugstreambase!char *ptr, int n, char ‘start) :buf(ptr, n, start) { 
1os::in1t(4th1s->buf); 

) 

_Cdecl debugstreambase!) :buf() { ios::init(&this->buf); } 
private: 

debugstreambuf buf; 

); 

templatetint SIZ = 256> class ODS: public debugstreambase, public ostream { 
public; 

ODS!) :debugstreambase(buf, sizeof buf, NULL), ostream(debugstreambase::rdbuf()) { 
*buf = ’\0’: 

debugstreambase::rdbuf()->seekoff(0, ios::beg, ios::out); 

) 

protected; 

char buf[SIZ]; // the output buffer 

); 

fendif 

/* End of File */ 


basis for adding permanent instrumentation to applica¬ 
tions, to be turned on and off for debug and ship ver¬ 
sions. When coupled with the capabilities of a monitor 
program (I use WinScope), ODS cannot be beaten for use¬ 
fulness, simplicity, and low overhead. Figure 1 shows an 
example of using the output debugging stream. 

In this code, the conditional DEBUG controls inclusion of 
diagnostics and diagnostic macro expansion. The file's 
name is saved once, to minimize its allocations when us¬ 


ing the Assert macro. Apparently, a new string is allocated 
each time __FILE_ appears. The Debug macro takes an out¬ 
put stream expression and sandwiches the debug stream 
and a stream flush around it. 

The Assert macro takes a logical expression and gener¬ 
ates a standard message if the expression is false. The 
message identifies the file name and line number of the 
Assert macro. To output the value of a pointer, cast it to 
void *. This outputs the pointer's value in hex. 
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When protecting your software against piracy and 
unauthorized use, make sure that your protection 
system has all the following qualities: 


A GOOD HARDWARE KEY 



Hardware-based software protection systems are now the 
standard worldwide. However, not all keys are the 
same. A good key should have all the following 
features: 

t/ Compatibility and transparency. The key 
should work without any problem on your 
customers’ computers. The user should be 
able to forget the key after connecting it. 

\/ Unbreakable electronics. A customized ASIC 
(Application Specific Integrated Circuit) component 
integrated into the key to prevent reverse engineering and make cracking 
the hardware virtually impossible. 


t/ A unique and inaccessible developer’s code burnt into the ASIC. This 


code should never be held in the key’s memory, where it can be read and 
altered. 

t/ A Read/Write Memory inside the key should be 
available. The memory should be writable in the 
field, on any PC, without any special programming 
equipment. 

l/ Very low power consumption, enabling the 
key to work even under the most adverse power 
conditions, on PCs and laptops, with or with¬ 
out a printer. 

POWERFUL SOFTWARE 

\/ A Linkable Protection Module with which calls can be made to 
the key from any point in the protected program. 

>/ An “Envelope" encryption program. Such programs enhance security 
while making it possible to protect a software application even without its 
source code. 

\/ Sophisticated antidebugging and encryption mechanisms. 




HASP'- The Professional Software 
Protection System 1 


MacHASP - The Professional Software Protection System for the Macintosh 


HASP® OFFERS YOU 
ALL THESE FEATURES 
AND MORE: 

HASP was designed by a team of computer ex¬ 
perts, professional cryptologists, and electrical 
engineers. As a result, HASP keys are supported 
by what is probably the best software in the mar¬ 
ket, and the HASP system has worked on every 
computer it has been tried on. In addition to all 
the features mentioned above, HASP provides: 

\/ A Full Authorization System for protecting 
dozens of programs using only one key. 

l/ A Pattern Code Security System (PCS) which 
enables parallel processing of multiple calls by 
the Linkable Protection Module. 

A Virus Detection option that can be in¬ 
corporated in the protected program to check 
whether it has been infected by a virus. 

\/ Several HASP keys can be connected one 
behind the other. Small physical size ensures 
maximum convenience for your customers. 

NETHASP- THE ULTIMATE 
SOFTWARE PROTECTION 
FOR NETWORKS 

Only one NetHASP key is needed to run a 
protected program from any station in a network. 
NetHASP provides full support for protecting DOS 
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non-dedicated servers, Lan Manager, Lantastic, 
Banyan, DLink, and NET-BIOS based LANs. 
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questioning procedures... and crack them. 
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MemoHASP: ...of all the protection devices test¬ 
ed is without any doubt, the one which combines 
the best features. 

PCompatible (Spain) 

Trying to crack a program... that was protected 
utilizing all of HASP’S features - is like search¬ 
ing for the Holy Grail. 

Micro Systems (France) 
PC dongles... come with varying claims as to 
their transparency. The majority suffer from 
problems when a printer is connected... the 
DESkey and HASP-3 are not affected... 

Program Now (Britain) 
Of all keys tested, HASP is the most ambitious 
one... the quality of HASP manufacturing seems 
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defense against software piracy... 
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Figure 1 test.c — Demonstrating the ODS class 


♦define DEBUG 
♦ifdef DEBUG 
♦include "ods.h" 

static char *_file =_FILE_; 

static ODSO debug; 

♦define Debug( _x_ ) debug « _x_ « endl 

♦define Assert( _c_ ) if( _c_ ) ; else Debug( "Assert: " «_file « «_LINE_) 

♦else 

♦define Debug( _x_ ) 

♦define Assert( _c_ ) 

♦endif 


int SomeClass::Method ( char *pl, 
char *p2, int p3 ) 

{ 

int ret = 0; 

Debug( "Method(" « pi « ", " « p2 « " « p3 « ")" ); 

Assert( pi != NULL ); 

II... 
if(foo) { 

Debug( "foo TRUE" ); 

II... 

} 

else { 

Debug( "foo FALSE" ); 

II... 

} 

II... 

Debug( "Method returned " « ret ); 
return ret; 

} /* Method */ 


The diagnostic output produced includes: 

• the method's invocation parameters. Notice how natural it 
is to format the diagnostic output as a function call. 


• an assertion that pi is not NULL. If pi is NULL, a diagnostic 
message with the current file name and line number is 
generated. 

• the truth value of foo. 

• the method's return value. 

Using additional macros, other shortcuts are supported: 

«efine VAR( _x_ ) " " « _x_ 

(Note that there are no spaces between the quoted strings 
and the #_x_; this causes the processor/compiler to coa¬ 
lesce the three strings into a single string.) The above 
macro takes advantage of the stringize operation of the 
preprocessor to generate the expression as a string, then 
its value, as in: 

Debug( VAR(info) « VAR(foo) « VAR(bar) ); 

The expansion is left as an exercise for those interested. 
The stringize operator could also be used to add the as¬ 
sert expression to the message of the Assert macro. 

Happy Hunting! 

I surprised myself with how well ODS works. Spy tools in 
themselves are invaluable, and ODS allows the developer 
to add critical diagnostic information to the displays of 
these programs. I am happy to share this with everyone, 
and hope it finds some use. □ 
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Speech Systems, Inc. has answered the demand for powerful, 
accurate speech recognition with its Phonetic Engine ® 5 00 
<PE500 m ), a state-of-the-art speech recognition system for 
Microsoft ® Windows™ applications. 


Talking 
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Computer 
Is No 
Longer 
A Dream 
ButA 
Reality 


The PE500 combines the features essential for de- 

veloping professional, speech-aware applications: 

• Continuous Speech, which allows you to speak with¬ 
out pauses betzoeen words. 

• Speaker Independence, ivhich lets you speak imme¬ 
diately without training. 

• Large Active Vocabulary, which gives you more 
freedom when designing your application. 

• 40,000 Word Standard Dictionary, which you can 
expand with new words. 

PE500 System Development Kit (PE500 SDK) — 

$995. Includes the following: 


• Interactive Speech Card. 

• Software Development Tools for C, C++, and 
Visual Basic. 

• Noise-canceling microphone. 


To receive a copy of the white paper "How to 
Develop Speech-Aware Applications" or to 
order your copy of the PE500 SDK, please con¬ 
tact us at 303.938.1110,303.938.1874 (fax), or 
at 2945 Center Green Court South, Boulder, 
Colorado 80301. 
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Brian G. Myers 


In "Writing a Windows Debugger" in the June 1992 issue of Windows/DOS 
Developer's Journal, Matt Pietrek outlined some of the problems involved in writ¬ 
ing a Windows debugger. One problem is that a debugger needs to modify 
code to insert breakpoints, but since Windows assumes read-only code pages, 
it may discard a code page and then swap it back in by reading it directly from 
the executable, wiping out any breakpoints that were set. A more complex 
problem results from the fact that the Windows messaging system is synchro¬ 
nous, which makes it difficult to avoid situations in which the debugger's user 
interface cannot receive user input because the debuggee has not finished 
processing one or more messages. 

Windows NT's Win32 API solves some of these problems. Preemptive multi¬ 
tasking and localized input queues prevent a debugging session from interfer¬ 
ing with other tasks in the system, so there is no need for synchronous and 
asynchronous debugging modes. NT provides copy-on-write protection for code 
pages, so as soon as the debugger attempts to modify a code page, NT makes 
a separate copy of the page for that instance of the application - the debug¬ 
ger's modifications will not be wiped out by swapping. New debugging API 
routines tell the debugger about events in the process it is debugging. And a 
multithreaded debugger can dedicate a thread to waiting for event notifications 
without having to merge the polling mechanism into its user interface code. 


Brian Myers has written three Windows programming books for Sybex. The most re¬ 
cent, written with Eric Hamer, is Mastering Windows NT Programming. Brian works 
for Borland International and occasionally teaches Win32 programming through a 
university extension in Silicon Valley. He can be reached on CompuServe at 
73204,1224. 
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Figure 1 Launching the debuggee 


void DoLaunchi HWND hWnd ) 

{ 

TCHAR szName[_MAX_FNAME*sizeof(TCHAR)] = TEXTC"'); 
TCHAR szPath[_MAX_PATH*sizeof(TCHAR)] = TEXTC'”); 
BOOL bSuccess; 

HANDLE hThread; /* debugging thread */ 

DWORD dwThreadID; 

/* ask user for name of file to open */ 
bSuccess = GetFi1eNameChWnd. szPath, szName); 
if (!bSuccess) 
return; 

/* create a thread to wait for debugging events */ 
gbContinueDebug = TRUE; 
hThread = CreateThread(NULL, 0, 

(LPTHREAD_START_ROUTINE)DebuggingThread, 
(LPTSTR)szPath, 0, JdwThreadlD); 
if (!hThread) { 

ShowErrorMsgC_LINE_); 

gbContinueDebug = FALSE; 
return; 


In the interest of portability, however, Win32 does not 
directly support any single-step, breakpoint, or watchpoint 
capabilities in the host CPU. To use these features, the de¬ 
bugger must manipulate directly the hardware context of 
individual threads. UNIX, OS/2, and Windows 3.1 (the lat¬ 
ter via undocumented means) give the debugger more di¬ 
rect support for the hardware's debugging features. A 
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than PVCS - at less than half the price 

* You’ll save five hours a week 

And you’ll never lose a file. 

We Guarantee it. 

For a free demo, call 
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hardware-independent debugger for Win32 must use dif¬ 
ferent low-level code depending upon which hardware 
platform it is currently executing on. Win32 also does not 
support the TOOLHELP API, which provides 16-bit Win¬ 
dows with many useful debugging functions, such as noti¬ 
fications of debugging events. You may have to construct 
your own equivalents from more primitive functions in the 
Win32 debugging API functions. 

As an introduction to the process of writing a Windows 
NT debugger, this article explains the Win32 debugging 
API and shows how to set breakpoints on an Intel CPU. 
My first sample program watches for its child to call Out- 
putDebugStringO and displays the messages when they 
come. My second sample loads a short program and lets 
the user set breakpoints on source code lines. It shows 
how to structure an interactive debugger, how to set and 
remove breakpoints, and how to manage both hard and 
soft breakpoints. 

Attaching the Debuggee Process 

The Windows NT system recognizes and supports the 
special relationship that arises between two processes 
when one is debugging the other. The debugger acquires 
special privileges for intruding on its 'child". (For conven¬ 
ience, I will call the program being debugged the child, 
though it need not be a child process launched by the 
debugger.) In order to acquire special debugging privi¬ 
leges, the debugger attaches itself to the child. There are 
two ways of attaching to a process. The easy way is to 
create the process yourself and set a debugging flag. 

STARTUPINFO sui; 

PROCESSJNFORMATION pi; 

/* fill in process’s startup info */ 

ZeroMemory(&sui, sizeof(STARTUPINFO)); 
sui.cb = sizeof(STARTUPINFO); 
sui.wShowWindow = SW_SHOWDEFAULT; 

I* create the debuggee process */ 

CreateProcess(NULL, 1pszFi1ePath. 

NULL, NULL. TRUE, DEBUG_PROCESS, 

NULL, NULL, &sui, &pi); 

The DEBUG_PR0CESS flag in the last command has two 
effects. First, it requests extra access privileges such as 
PROCESSJH_READ and PROCESSJMJRITE. A debugger needs 
these privileges in order to read and write data from the 
child's protected address space. The handle that 
CreateProcessO returns in pi.hProcess will have the extra 
debugging privileges. Second, the DEBUG_PR0CESS flag tells 
the system that the parent process wants to know when 
the child does anything important, such as load DLLs, cre¬ 
ate threads, cause exceptions, or terminate. In a minute 
I'll explain what else the debugger must do to receive 
debugging notifications, but they won't arrive at all unless 
the debugger uses the DEBUG_PR0CESS flag. 

A debugger may also attach itself to a process that 
already exists, but that is harder, because the debugger 
must know the process's ID number first. To attach to a 
running process, use this function: 
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BOOL DebugActiveProcess(DWORD dwProcessId) 

DebugActiveProcessO lets the debugger adopt a child it did 
not create. It's easy to adopt children you wrote because 
you can make them pass their own IDs to the debugger, 
perhaps in a message or through a pipe. The only way to 
determine the ID of an unknown process, however, is to 
enumerate the IDs of all the active processes from the 
system registry (see my article, 'Enumerating Processes in 
Windows NT' in the April issue of Windows/DOS Devel¬ 
oper's Journal). 

Receiving Event Notifications 

At the core of any debugger written for Windows NT 
you'll find some version of this loop. 

DEBUG_EVENT Event; 

BOOL bDebugging = TRUE; 
while (bDebugging) { 

WaitForDebugEvent(&Event, INFINITE); 
switch(Event.dwDebugEventCode) { 

/* recognize and handle 

debugging events */ 

} 

/* allow debuggee to resume execution */ 

ContinueDebugEvent(Event.dwProcessId, 

Event.dwThreadld, DBG_CONTINUE); 

} 


Figure 1 continued 

1 

CloseHandle(hThread): 

1 

LRESULT DebuggingThread( LPCTSTR IpszFilePath 
{ 

STARTUPINFO sui; 

PROCESSJNFORMATION pi; 

BOOL bSuccess; 

DEBUG.EVENT DebugEvent; 


/* fill in the process’s startup information 
ZeroMemoryt Usui, sizeof(STARTUPINFO) ); 
sui.cb = sizeof(STARTUPINFO); 
sui.wShowWindow = SW_SHOWDEFAULT; 

*/ 

pi. hProcess = NULL; 


/* create the debuggee process */ 

bSuccess = CreateProcess(NULL. IpszFilePath, NULL, 

NULL, TRUE, DEBUG_PROCESS I DEBUG_ONLY_THIS_PROCESS. 


UaitForDebugEventO makes the debugging thread block un¬ 
til the child process does something noteworthy. When an 
event occurs and UaitForDebugEventO returns, the system 
automatically freezes all the child's threads. The child re¬ 
mains frozen until the debugger calls ContinueDebugEventO. 
A debugger must call both UaitForDebugEventO and Con¬ 
tinueDebugEventO in order to receive event notifications from 
the child. Furthermore, the thread that calls the commands 
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Figure 1 continued 


NULL. NULL, isui, &pi); 

DebugEvent.u.DebugString.nDebugStringLength, 

if (! bSuccess) { 

AdwBytesRead); 

ShowErrorMsg( LINE_ ): 

if (! bSuccess) 

gbContinueDebug = FALSE; 

ShowErrorMsg(_LINE_); 

ExitThreadt 1 ); 

Edit_Append(ghEditBox, szDebugString); 

} 

break: 

CloseHandlef pi.hProcess ); 


CloseHandlef pi.hThread ); 

case EXIT PROCESS DEBUG EVENT: 

while (gbContinueDebug) { 

Edit_Append(ghEditBox, "DETACHING" ); 
gbContinueDebug = FALSE; 

DWORD dwBytesRead; 

break; 

TCHAR szDebugString[256]: 

) 

/* block until a debugging event occurs */ 

/* allow debuggee to resume execution */ 

ContinueDebugEvent(DebugEvent.dwProcessId, 

WaitForDebugEvent(&DebugEvent, INFINITE); 

DebugEvent.dwThreadld, DBG CONTINUE); 

} 

return(OL): 

} 

switch (DebugEvent.dwDebugEventCode) { 

case OUTPUT_DEBUG_STRING_EVENT: 
bSuccess = ReadProcessMemory(pi.hProcess, 

DebugEvent.u.DebugString. 1 pDebugStringData, 

/* End of File */ 

szDebugString, 



must be the same thread that created or adopted the 
child. If a different thread calls UaitForDebugEventO, the 
function always returns FALSE. 

The requirements of the debugging loop influence the 
structure of a debugger. Most debuggers spin off a new 
thread when the user chooses a process to debug. The 
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new thread handles debugging events, and the original 
thread handles the debugger's user interface. The debug¬ 
ging thread begins by attaching to a child, then enters an 
event loop, and ends when the child ends. 

A Simple Debugging Monitor 

That's enough background to build a simple debugging 
monitor that logs to its window messages from the child 
process. One of the events a debugger can receive is 0UT- 
PUT_DEBUG_STRING_EVENT, and it occurs whenever the child 
calls OutputDebugStringO. Under 16-bit Windows, OutputDe- 
bugStringO results in an event notification that you can 
receive via the TooIHelp function NotifyRegisterCallbackO 
(which is how Microsoft's DBWIN utility displays the out¬ 
put from OutputDebugStringO). My DBTrace utility waits for 
events generated by OutputDebugStringO and displays 
them. DBTrace fills its client area with an edit control and 
prints the messages there. It begins by asking the user to 
choose an . exe file which it then launches. Figure 1 shows 
the parts of DBTrace that launch the child and wait for 
events; the complete code is on the code disk (see the 
Online Source Code box in the table of contents for avail¬ 
ability). Figure 2 shows a typical DBTrace session in pro¬ 
gress. 

The challenge in handling OUTPUT_DEBUG_STRING_EVENT no¬ 
tifications is extracting the message text. Unlike the 16-bit 
version of OutputDebugStringO, the Win32 version does not 
send anything from the child to the debugger; it merely 
transfers control to the debugger. The structures that 
come with the notification tell the debugger where the 
child's execution broke off. The debugger must use that 
information to peek into the child's address space, find 
the message text, and copy the message into its own 
space. Fiere is the code to do that: 

bSuccess = ReadProcessMemorytpi.hProcess, 

Event.u.DebugString.1pDebugStringData, 
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szDebugString, 

Event.u.DebugString.nDebugStringLength, 

&dwBytesRead); 

Edit_Append(ghEditBox, szDebugString); 

ReadProcessMemoryO copies information from the address 
space of one process into the address space of another. 
The handle passed in the first parameter must permit 
PR0CESS_VM_READ access. The Event structure, filled in by 
MaitForDebugEventO, contains information relevant to the 
most recent event. The Event, u field of the structure is a 
union. What you look for in the un¬ 
ion field depends on the event that 
just occurred. After an 0UTPUT_DE- 
BUG_STRING_EVENT, the union contains 
an OUTPUT_DEBUG__STRING_INFO structure 
in a field called DebugString. This 
structure gives the length and loca¬ 
tion of the message string in the 
child process. ReadProcessMemoryO cop¬ 
ies the string into the debugger's 
own buffer, szDebugString. Edit_Ap- 
pendO adds the string to the end of 
the edit control buffer where DBTrace 
displays messages. 

As an enhancement to DBTrace, it 
would be easy to expand the switch 
statement in the event loop and log 
other events as well. 

switch (DebugEvent.dwDebugEventCode) { 
case CREATE_PROCESS_DEBUG_EVENT: 

Edit_Append(ghEditBox, "created process"); 
break; 

case CREATE_THREAD_DEBUG_EVENT: 

Edit_Append(ghEditBox, "created thread"): 
break; 

case LOAD_DLL_DEBUG_EVENT: 

Edit_Append(ghEditbox, "loaded DLL"); 
break; 

case EXIT_PROCESS_DEBUG_EVENT: 

Edit_AppendCghEditBox, "process ended" ); 
bContinueDebug = FALSE; 
break; 

} 

From the Event structure, each case 
could gather information about the 
event and print more specific mes¬ 
sages. Table 1 lists all the possible 
events a debugger might receive. 

Common Debugging Tasks 

Debuggers do more than log 
events. Once you have gained a de¬ 
bugger's access privileges, you might 
undertake a variety of useful tasks: 

• Map the child's address space. 

For this, you use Win32's 
Virtual Query Ex() function to re¬ 
trieve information about blocks of 


memory in another process. By starting with an ad¬ 
dress of 0 and working your way up to the top of the 
child's address space, you can map every block of 
memory and show whether it is free, reserved, or com¬ 
mitted and how it is protected. 

Freeze and thaw the child's threads. From the CRE- 
ATE_THREAD events, you can build a list of all the child's 
threads. SuspendThreadO and ResumeThreadO can make 
individual threads stop and start at will. This may be 
useful to help solve thread synchronization problems. 
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Debug Trace 


B3 


File Edit 


launched child 

—exception_debug_event at 0x771 ACCAO 
breakpoint exception 

—end of case EXCEPTIONDEBUGEVENT 
ToggleBreakpoint 

Creating new breakpoint at line 4 [0x0041004F] 
SETBP: address=0x41004F oldcode=0x55 
BP TOGGLED ON 
launched child 

—exception_debug_event at 0x771 ACCAO 
breakpoint exception 

—end of case EXCEPTION DEBUG EVENT 

ToggleBreakpoint 

BP TOGGLED OFF 


CL 


Figure 2 DBTrace session in progress 


• Change execution priority. To fine-tune the child's 
performance, modify the process's base priority (SetPri- 
orityClassO) or the dynamic priority of individual 
threads (SetThreadPriorityO). 
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• Execute in single-stepping mode. Using GetThreadCon- 
textO and SetThreadContextO, you can toggle the CPU's 
single-step register bit. (Not ail CPUs support this, but 
Intel does.) In single-step mode the processor stops af¬ 
ter executing each machine instruction. This is good for 
stepping through disassembled code, but has other 
uses too, as you'll see in my Stepper program later in 
this article. 

• Retrieve symbolic information. A symbolic debugger 
is one that understands the symbols, such as variable 
and function names, used in the source code, if you 
use the appropriate compiler and linker options to cre¬ 
ate an .exe with debugging information, then the de¬ 
bugger can read the .exe to interpret your symbols. A 
symbolic debugger needs the information in order to 
step through source code lines, inspect variables by 
name, or show what procedures have been called by 
reading the stack. 

• Set breakpoints. Most of the rest of this article concen¬ 
trates on breakpoints. 

Breakpoints: The Stepper Program 

Microsoft's examples for the Win32 debugging API 
don't go much beyond the kind of passive monitoring 
that DBTrace performs. As you might expect, unantici¬ 
pated complications arise in any non-trivial example. Inter¬ 
preting symbol information could be the subject of a book 
in itself, so I've settled more modestly on breakpoints for 
my example. A debugger inserts breakpoints into the de- 
buggee's code in order to interrupt execution at strategic 
moments. 

All Intel processors in the 80x86 family support soft¬ 
ware interrupts via the INT instruction. Normally, this is a 
two-byte instruction, since the first byte is an opcode (0xCQ 
and the second byte specifies one of 256 possible inter¬ 
rupt numbers. However, Intel also created a special one- 
byte form of this opcode (0xCC) for INT 03h, specifically to 
support software debuggers. The general idea is that a de¬ 
bugger installs its own INT 03h handler and then replaces 
the first byte of the instruction that it wants to break on 
with 0xCC. When execution reaches that point, an INT 03h 
occurs and the debugger gets control, performs any re¬ 
quired task, then restores the original instruction byte and 
resumes execution. 

The reason it is crucial to have a one-byte form of the 
INT instruction is that some 80x86 instructions are only 
one byte long, if the debugger tried to install a two-byte 
INT instruction in that case, it would also be modifying the 
first byte of the next instruction in the debuggee. In gen¬ 
eral, there would be no way of ensuring that the debug¬ 
gee did not contain a jump directly to that second instruc¬ 
tion, and if such a jump were taken at runtime, then the 
debugger would never have a chance to restore the origi¬ 
nal opcodes and disaster would ensue. 

My Stepper program launches a single-threaded child 
program called foo.exe. Stepper displays the source code 
from foo.c, as shown in Figure 3. The minus signs ('-') 
indicate lines where a breakpoint may occur. It doesn't 
make sense to break, for example, on the line 
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finclude <windows.h> 

because the line generates no machine instructions. Also, 
if the programmer happens to split the code for a single 
function call over several lines, only one line supports a 
breakpoint. Stepper marks the legal break lines with a mi¬ 
nus sign in the left margin. 

Using commands from the Run menu, the user may set 
a breakpoint on any break line. Stepper indicates active 
breakpoints by changing the character to a '+' charac¬ 
ter. The F9 key starts foo.exe running, but execution halts 
at any breakpoint. A *»' character marks the line where 
the program halted. You can also put the cursor on a line 
and press F4 to make the program run up to the cursor 
line. As you will see, the run-to-line feature adds consider¬ 
able complexity to the debugger code. 

A Shortcut to Symbol Information 

I'm going to describe the interesting parts of Stepper 
from the top down, but one bottom-level detail requires 
attention first: the problem of matching source code lines 
with machine code. To set breakpoints in source code, a 
debugger needs to know at what address the instructions 
corresponding to each line begin. The linker's debugging 
switches make it copy line information (and much else be¬ 
sides) into the .exe file. Both Borland and Microsoft have 
published the format of their symbolic debugging informa¬ 
tion. Microsoft's specification is on the Microsoft Devel¬ 
oper's Network CD-ROM and Borland's is in the Borland 
Open Architecture Flandbook, available for download from 
CompuServe in the BCPPWIN forum. Under Windows NT a 
debugger has easy access to the symbol information, be¬ 
cause when a CREA TE_PROCESS_DEBUG_EVENT occurs, the sys¬ 
tem passes the debugger a pointer to the beginning of the 
child's executable image and an off¬ 
set from there to the beginning of 
the child's symbolic debugging infor¬ 
mation. 

You can see the information for 
yourself by running one of the many 
utilities that dump information from 
a .exe file. In order to dump line 
number information from a .exe file, 
you must build the program with de¬ 
bug switches. For Borland, this means 
using the '-v' switch and calling 
TDUMP.exe. 

TLINK32 -Tpe -ap -v -Lc:\bc4\lib 
C0x32 foo, foo,, 
cw32 import32,, 

TDUMP foo.exe 

For Microsoft, it means telling LINK32 
to use COFF debug information only 
and then calling LINK32 a second 
time to dump the information. 


LINK32 -debugifull -debugtype:COFF 
-subsystem:console -out:foo.exe 
foo.obj libc.lib kernel32.1ib 
LINK32 -dump -linenumbers foo.exe 

Both TDUMP and LINK32 -DUMP parse the .exe and trans¬ 
late the information into a more readable format. The 
dump listings match line numbers to code offsets. I have 
hard-coded foo.exe' s line breaks into Stepper. Table 2 
shows partial dumps from both the Microsoft and Borland 
utilities, along with the arrays that Stepper declares to 
hold the necessary information. A real debugger would 
gather the information for itself from foo.exe. 

Both dump utilities match line numbers to offsets, but 
they measure the offsets from different origins. Microsoft 
gives offsets from the base of the loaded executable file 
image. Borland gives offsets from the first instruction in 
the program (mainO or UinMainO). When the linker loads 
an executable image into memory, the first byte of the 
image is not the first byte of code. The image begins with 
a header describing the sections that follow; where the 
actual code begins varies. When the debugger launches a 
program to debug, Windows NT tells the debugger both 
addresses, the image base and the starting address. To 
determine the address where a specific source line begins, 
you add its offset to one of those origins. The functions in 
Stepper that work with line addresses calculate offsets the 
Borland way, starting from the first instruction. To modify 
the code for Microsoft tools, look for the lines that refer to 
the value stored in Debuggee.pStartAddress and change 
them to use Debuggee.pImageBase instead. To determine at 
runtime which kind of offset the program uses, you would 
have to parse the .exe file and find its debug directory 
table. 


Table 1 Win32 Debugging Events 

CREATE _THREAD_DEBUG_EVENT 

The child created a new thread. Creation of the 
primary thread does not generate a CREATE_THREAD 
event. 

CR E ATE_PR OCESS_D EBUG_EVENT 

The child has been created. Its DLLs have not yet 
been loaded. 

EXIT_THREAD_DEBUG_EVENT 

One of the child's threads ended. When the last 
thread ends you get only an EXIT PROCESS event. 

EXIT_PROCESS_DEBUG_EVENT 

The child has ended or been terminated. 

LOAD_DLL_DEBUG_EVENT 

The child has loaded a DLL, either at load-time or at 
run-time. 

UNLOAD_DLL_DEBUG_INFO 

The child has unloaded a DLL. When the process 
exits, no unload events are generated for libraries 
loaded statically at load-time. 

EXCEPTION_DEBUGJNFO 

The child produced a system exception. Examine the 
DEBUG_EVENT structure to determine whether the 
exception was, for example, a breakpoint or an access 
violation. 

OUTPUT_DEBUG_STRING_EVENT 

The child called OutputDebugString. Examine the 
DEBUG_EVENT structure to find the message text and 
copy it from the child's address space. 

RIP_EVENT 

A system debugging error occurred. 
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Figure 3 The simple NT debugger in action 


Figure 4 Outline of main loop for simple debugger 


LaunchDebuggeeO; 
gbAttached = TRUE; 

SetEvent(ghCommandEvent[EVENT__RUNNING]); 

_try { 

_try { 

while (gbAttached) { 

/* wait for event signals */ 

iCmdEvent = WaitForMultipleObjectsUghCommandEvent) 

switch (iCmdEvent) { 
case EVENT_RUNNING: 

CheckForDebugEventO; 

break; 

case EVENT_RE$UME: 

SetEvent(ghCommandEvent[EVENT_RUNNING]): 
ContinueDebugEventt Debuggee.dwProcessId, 
Debuggee.dwThreadld, DBG_CONTINUE); 
break; 

case EVENTJGLL: 

TerminateProcess(); 
gbAttached = FALSE; 
break; 

) 

} 

} _finally { 

ResetEvent(ghCommandEvent[EVENT_RUNNING]); 
gbAttached = FALSE; 

} 

}_except (EXCEPTION_EXECUTE_HANDLER) { 

MessageBoxO; 

) 

/* End of File */ 


Figure 5 Excerpts from debug.c 

/*. 

STEPPER.H (excerpts) 

—*/ 

typedef struct bpnodet 

UINT uLine; /* source line of bp */ 

PBYTE pAddress; /* code address of bp */ 

BYTE Opcode; /* displaced instruction */ 

BOOL bOnceOnly; /* TRUE for soft break */ 



Figure 5 continued 


_ 

struct bpnode *pNext; /* next node in list */ 

} BPNODE; 

typedef BPNODE *PBPN0DE; 
enum EVENTS { 

EVENT_RUNNING, EVENT_RESUME, EVENT_KILL 

}; 

((define NUH_COMHAND_EVENTS 3 

/* flags for SetLinePrefixO */ 
enum PREFIX_MARK { 

PREFIX_BREAK_LINE, PREFIXJREAKPOINT, PREFIX_CURRENT_LINE 

}; 

((define ERROR_MSG(h) ShowErrorMsg((h), _FILE__LINE_) 


AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA 


DEBUG.C 

Routines for the debugging thread of the 
STEPPER program. 


((define STRICT 
((include <windows.h> 

((include <windowsx.h> 

((include <stdlib.h> /* _MAX_PATH */ 
((include "stepper.h" 


*/ 


/*---. 

TYPES AND DEFINITIONS 

*/ 

((define BP_0PC0DE 0xCC /* INT 3 instruction */ 

((define TF_BIT 0x100 /* single-step register bit */ 

typedef struct tagDEBUGGEE { 

PBYTE pStartAddress; /* address of main() */ 

HANDLE hProcess; /* process under scrutiny */ 

HANDLE hThread; /* primary thread */ 

DWORD dwProcessId; 

DWORD dwThreadld; 

BOOL bBreakSeen; /* FALSE until first bp occurs */ 

} DEBUGGEE; 

typedef DEBUGGEE *PDEBUGGEE; 


/* . 

GLOBAL VARIABLES (all modules) 


extern HWND ghMainWnd; 
extern TCHAR gszAppTitle[]; 
extern BOOL gbAttached; 
extern BOOL gbPaused; 

extern HANDLE ghCommandEvent[NUM_COMMAND_EVENTS]; 


.*/ 


/*- . 

STATIC VARIABLES (this module only) 

. . . —*/ 

DEBUGGEE Debuggee; 

PBPNODE pbpPending = NULL; 

/* FOO.EXE line information (assumes */ 

/* Foo was compiled with Borland tools) */ 

int LineAddress[] = {0x4F, 0x53, 0x57, 0x66, 

0x6C, 0x71, 0x73); 

int BreakLinest] = (4, 7, 8, 7, 9, 10, 0}; 
int iBreakLineCount = 7; 

/*--- 

DEBUGGING THREAD 

*/ 

LRESULT DebuggingThreadt LPCTSTR pszFilePath ) 

{ 

PROCESSJNFORMATION pi; 
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Command Events and Debugging Events 

When Stepper begins executing, it creates a second 
thread to perform the debugging. The second thread 
launches foo.exe and enters a debugging loop. Meanwhile, 
the first thread continues to process window messages 
and manage the user interface. The code for the user in¬ 
terface thread resides in a file called stepper, c, while most 
of the debugging thread's code resides in debug, c. A third 
file, bpnode.c, contains functions for managing a linked list 
of breakpoints. The other two modules are available on 
the code disk (see the Online Source Code box in the ta¬ 
ble of contents for availability). 

This division of labor poses a problem that did not 
arise in DBTrace. In DBTrace the user interface thread has 
its message loop and the debugging thread has its event 
loop. Until the program ends, neither loop cares what the 
other is doing. In Stepper, on the other hand, the debug¬ 
ging thread must respond to commands received through 
the user interface. The user signals where to set break¬ 
points, when to resume execution, and when to terminate 
the child. But if the debugging thread spends most of its 
time blocking in MaitForDebugEventO, how can the user in¬ 
terface thread interrupt to signal a command event? 

The answer is a larger loop that calls MaitForMultipleOb- 
jectsO on each iteration to wait for one of three event 
synchronization objects that Stepper creates during initiali¬ 
zation. Two of them represent user interface commands: 
EVENT_RESUME and EVENT_KILL. If the user interface thread 


Figure 5 continued 


TCHAR szMsg[_MAX_PATH + 25]; 
int iCmdEvent; 

/* create the debuggee process */ 
if (!LaunchDebuggeeCpszFi1ePath, &pi)) { 
wsprintf( szMsg, TEXTCCannot launch its"), 
(PSTR)pszFilePath); 

MessageBoxt ghMainWnd, szMsg. gszAppTitle, 

MB_0K I MBJCONEXCLAMATION ); 
gbAttached = FALSE; 

} else { 

gbAttached = TRUE; /* creation succeeded */ 
SetEvent(ghCommandEvent[EVENT_RUNNING]): 

} 

SetWindowTitleO; 

_try { 

_try { 

while (gbAttached) { 

/* proceed only when a command event permits it */ 
iCmdEvent = WaitForMultipieObjects( 
NUM_COMMAND_EVENTS, (PHANDLE )&ghCommandEvent. 
FALSE, INFINITE); 

switch (iCmdEvent) { 

case EVENT_RUNNING: 

CheckForDebugEventtpi.hProcess); 
break; 

case EVENT_RESUME: 

SetEventt ghCommandEvent[EVENT_RUNNING]); 
gbPaused = FALSE; 

SetWindowTitleO; 

ContinueDebugEventt Debuggee.dwProcessId, 


Table 2 Symbolic line information dumped from .exe 


Output from Microsoft's LINK32 -DUMP 


COFF LINENUMBERS #1 

1000 5 1009 7 1022 8 

1038 9 103D A 

Output from Borland's TDUMP.EXE 


Source files: 

File: test2.c [002] Offset: 078BA 
Range: 0001:0004F-00073 
Line numbers: 

0004:0004F 0007:00053 0008:00057 0007:00066 
0009:00060 0010:00071 0000:00073 

How Stepper records Borland’s line number data 


int LineAddress[] = {0x4F, 0x53, 0x57, 0x66, 
0x6C, 0x71, 0x73}; 

int 8reakLines[] = {4, 7, 8, 7. 9, 10, 0}; 
int iBreakLineCount = 7; 


sets either of these events, the debugging thread notices 
and responds. Most of the time, however, both are off 
and the third, EVENT_RUNNING, remains on. Because one 
event is usually on, the WaitForMultipleObjectsO command 
usually returns at once. Then each iteration of the large 
loop checks briefly for a debugging event, responds if 
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Figure 1. Detailed timestamping of C library fread() function call. 
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necessary, and returns back to the larger command loop. 
In code stripped of unessential details, Figure 4 shows an 
outline of the main DebuggingThreadO procedure. 

Within this command loop, the task of receiving debug 
notifications falls to CheckForDebugEventO, shown in Figure 
5. When it calls UaitForDebugEventO, this procedure sets a 
maximum blocking time of TOO milliseconds. If the time 
limit passes uneventfully, execution returns to the main 
command loop. If the RUNNING_EVENT signal is still on, the 
program comes back for another 100-millisecond wait. 
The addition of an exception and a termination handler 
make the debugger much more robust. When a debugger 
picks at the innards of its child, many things can go 


wrong. The exception handler ensures that even if an un¬ 
expected error causes the debugging thread to end, the 
debugger itself continues to run. The termination handler 
ensures that the gbAttached variable always accurately re¬ 
flects the program's state even after an unexpected error. 
(The primary thread reads gbAttached when deciding what 
menu commands to enable or disable.) 

When the debugger discovers that the child has en¬ 
countered a breakpoint, CheckForDebugEventO skips its 
usual call to ContinueDebugEventO. Skipping the call leaves 
the child completely frozen so the user can examine the 
state of the program at leisure. When the user issues a 
command such as Run, the user interface thread sets the 


Figure 5 continued 


Debuggee.dwThreadld, DBGJONTINUE); 
break; 

case EVENTJULL: 

/* the termination handler cleans up */ 
TerminateProcessfpi.hProcess, 0); 
gbAttached = FALSE; 
break; 

} /* end switch (iCmdEvent) */ 

} /* end while (bAttached) */ 

}_finally { 

/* clean up */ 

ResetEvent(ghCommandEvent[EVENT_RUNNING]); 
gbAttached = FALSE; 

SetWindowTitle(); 

DestroyListO; 

CloseHandle(pi.hProcess); 

CloseHandletpi.hThread); 

} 

}_except (EXCEPTION_EXECUTE_HANDLER) { 

MessageBoxCghMainWnd, "An unexpected error occurred.”, 
gszAppTitle, MB_0K I MBJCONSTOP); 

} 

return(OL); 

} 

/*. 

LAUNCH OEBUGGEE 

.*/ 

BOOL LaunchDebuggeef 

LPCTSTR pszFi 1 ePath, PPROCESSJNFORMATION ppi ) 

{ 

STARTUPINFO sui; 

BOOL bSuccess; 

/* fill in the process's startup information */ 

ZeroMemoryUsui, sizeof(STARTUPINFO)); 

sui.cb = sizeof(STARTUPlNFO); 

sui.wShowWindow = SW_SHOWDEFAULT; 

sui.dwFlags = STARTFJJSESHOWWINDOW; 

ppi-ShProcess = NULL; 

/* create the debuggee process */ 
bSuccess = CreateProcesstNULL, pszFi1ePath, 

NULL, NULL, FALSE, DEBUG_PROCESS I 
DEBUG_ONLY_THIS_PROCESS, NULL, NULL, &sui, ppi); 
if (IbSuccess) ERR0R_MSG( ghMai nWnd); 

return(bSuccess); 

} 


/*. 

CHECK FOR DEBUG EVENT 

.*/ 

void CheckForDebugEventCHANDLE hDebuggee) 

{ 

DEBUGJVENT DebugEvent; 

BOOL bContinue = TRUE; 

/* wait up to 100 ms for a debug event to occur */ 
if (WaitForDebugEventC&DebugEvent, 100)) { 

/* determine what event occurred */ 
switch (DebugEvent.dwDebugEventCode) { 

case EXCEPTION_DEBUG_EVENT: 
bContinue = DoExceptionEventUDebugEvent, hDebuggee); 
break; 

case CREATE_PROCESS_DEBUG_EVENT: 
gbAttached = TRUE; 

Debuggee.pStartAddress = 

(PBYTE)DebugEvent.u.CreateProcessInfo.1pSta rtAddress; 
Debuggee.hProcess = hDebuggee; 

Debuggee.dwProcessId = DebugEvent.dwProcessId; 

Debuggee. hThread = DebugEvent.u.CreateProcessInfo.hThread; 
Debuggee.dwThreadld = DebugEvent.dwThreadld; 

Debuggee.bBreakSeen = FALSE; 
break; 

case EXIT_PROCESS_DEBUG_EVENT: 
gbAttached = FALSE; 

SetWi ndowTitleO; 

MessageBoxCghMainWnd, "The program ended.", 
gszAppTitle, MB_0K I MBJCONINFORMATION); 
break; 

} /* end switch (EventCode) */ 

/* Unless the debuggee is paused at a */ 

/* breakpoint, resume execution of debuggee */ 
if (bContinue) 

ContinueDebugEvent(DebugEvent.dwProcessId. 

DebugEvent.dwThreadld. DBGJONTINUE); 
else { 

gbPaused = TRUE; 

SetWindowTitle(); 

ResetEvent(ghCommandEvent[EVENT_RUNNING]); 

} 

} 

) 

/* End of File */ 
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RESUME event. When the debugger finds that event set, it 
finally makes the deferred call to ContinueDebugEventO, al¬ 
lowing the child to resume execution. 

Only three debugging events interest Stepper: process 
creation, process termination, and exceptions. When the 
child is created, Stepper stores some thread and process 
ID values in a static structure for future reference. Stepper 


also sets the bBreakSeen field of this structure to FALSE. The 
first break signal a debugger receives is not a true break¬ 
point. After the system creates a child process and loads 
its DLLs, it needs to tell the debugger the child is about to 
begin execution. To do this it simulates a breakpoint at 
the place where the system code is about to jump into 
mainO or UinMainO. From the debugger's point of view this 


Figure 6 Exception handling code for simple debugger 


/*. 

DO EXCEPTION EVENT 

Respond to EXCEPTION_DEBUG_EVENT$, particularly 
breakpoints. Return TRUE if the debug loop 
may continue immediately to the next event, FALSE 
if it should wait for the user to resume. 

. */ 

BOOL DoExceptionEventt 
LPDEBUGJVENT pde, HANDLE hDebuggee ) 

{ 

BOOL bContinue; 

UINT uXCode = 

pde->u.Exception.ExceptionRecord.ExceptionCode; 

PBYTE pXAddress = 

pde->u.Exception.ExceptionRecord.ExceptionAddress; 

switch (uXCode) { 

case EXCEPTION_BREAKPOINT: 
pbpPending = OnBreakpointException(pXAddress); 
bContinue * FALSE; 
break; 


case EXCEPT10N_SINGLE_STEP: 

/* end single-step mode */ 

SetStepFlag(Debuggee.hThread, FALSE); 

/* restore the breakpoint we just stepped over */ 
if (pbpPending) 

SetBreakpoint(hDebuggee, pbpPending); 
pbpPending = NULL; 
bContinue = TRUE; 
break; 

} 

return(bContinue); 

} 

/*. 

ON BREAKPOINT EXCEPTION 

.*/ 

PBPNODE OnBreakpointException( PBYTE pXAddress ) 

{ 

PBPNODE pBP; 

PBPNODE pbpPassed = NULL; 

/* The first breakpoint is supplied by */ 

/* NT when the program loads */ 
if HDebuggee.bBreakSeen) { 

Debuggee.bBreakSeen = TRUE; 
return(NULL); 


/* is this a known breakpoint? */ 
pBP = FindBPbyAddress(pXAddress); 

/* has the debuggee stopped on a known breakpoint? */ 
if (pBP) { 

SetLinePrefix(pBP->uLine, PREFIX_CURRENT_LINE); 

/* get the INT3 opcode out of there */ 

RemoveBreakpoint(Debuggee.hProcess, pBP); 

if (ipBP->b0nce0nly) { 

/* For a hard break, turn on single-stepping */ 

/* to restore the INT 3 opcode later */ 

SetStepFlag(Debuggee.hThread, TRUE); 
pbpPassed = pBP; 

} else 

/* for a soft break, remove all traces */ 
DeleteNode(pBP); 

/* Reset the IP to execute the instruction */ 

/* displaced by the INT 3 opcode */ 
DecrementIPtDebuggee.hThread); 

} else { /* unknown breakpoint */ 

SetLinePrefix(0, PREFIX_CURRENT_LINE); 

} 

/* Return pointer to the breakpoint if it must */ 

/* be restored after the next single-step exception */ 
return(pbpPassed); 

} 

/***★***★•*•**★★***★*************★★*****★*****★*★★★■*•★★*★ 
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first breakpoint differs from all others because no actual 
0xCC instruction was inserted in the child's code to produce 
it. The bBreakSeen flag helps Stepper avoid tidying up a 
mess that isn't there. 

Breakpoint Exceptions 

Process creation and termination events, however, in¬ 
terest Stepper much less than exceptions because break¬ 
point instructions surface in the debugger as exceptions. 
The two routines that handle exceptions, DoExcep- 
tionEventO and OnBreakpointExceptionO, appear in Figure 
6. DoExceptionEventO recognizes breakpoint exceptions and 
single-step exceptions (I'll return to single-stepping in a 
few paragraphs). On encountering a breakpoint, DoExcep¬ 
tionEventO calls OnBreakpointExceptionO to ask three ques¬ 
tions about the breakpoint that just occurred. 

• Is this the very first breakpoint? 

• Is this a known breakpoint that Stepper set? 

• Is this breakpoint permanent or temporary? 

The very first breakpoint is the one the system sets, so 
OnBreakpointExceptionO simply resets the bBreakSeen flag 
and returns. On subsequent breakpoint exceptions, the pro¬ 
gram compares the address where the exception occurred to 
the addresses of all the breakpoints in its linked list. It is 
entirely possible for a breakpoint to occur without the de¬ 
bugger setting it. The child may cause breakpoints to oc¬ 
cur if it calls the DebugBreakO Win32 function. For break¬ 
points it doesn't recognize, Stepper takes no special 
action, but known breakpoints do require action. The 


Figure 6 continued 


THE FOLLOWING ROUTINES ASSUME AN INTEL CPU 

★ ★★★★★★★★★★★★★★★★★★★★★★★♦★★★★★★★★★★★★★★★★★★★★★★★★★★It** j 

/*. 

SET STEP FLAG 

Turn the TF (trap flag) off or on to enable or 
disable single-stepping mode. 

.-*/ 

BOOL SetStepFlag( HANDLE hThread, BOOL bOn ) 

{ 

CONTEXT Context; 

BOOL bSuccess; 

Context.ContextFlags = CO NT E XT_C0 NT RO L; 

_try { 

bSuccess = GetThreadContextthThread, AContext); 
if (bSuccess) { 
if (bOn) 

Context.EFlags \= TF_BIT; 
else 

Context.EFlags A= ~TF_BIT; 

bSuccess = SetThreadContext(hThread, AContext); 

} 

} _except (EXCEPTION_EXECUTE_HANDLER) { 
bSuccess = FALSE; 

} 

return(bSuccess); 

} 

/* . 

GET IP ADDRESS 

Return the current value of the instruction 
pointer from the context of a given thread. 
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Figure 6 continued 


. */ 

PBYTE GetIPAddress( HANDLE hThread ) 

{ 

CONTEXT Context; 

__try { 

Context.ContextFlags = CONTEXT_CONTROl; 
GetThreadContextthThread, iContext); 

} _except (EXCEPTION_EXECUTE_HANDLER) { 

Context.Eip = 0L; 

} 

returnt(PBYTE JContext.Eip); 

} 

/*. 

DECREMENT IP 

Set the instruction pointer back one byte. 

. */ 

BOOL Decrements HANDLE hThread ) 

{ 

CONTEXT Context; 

BOOL bSuccess; 

Context.ContextFlags « C0NTEXT_C0NTR0L; 
bSuccess = GetThreadContextlhThread. SContext); 
if (bSuccess) { 

Context.Eip--; 

bSuccess = SetThreadContextthThread, SContext); 

) 

return(bSuccess); 

} 


/* End of File */ 


debugger must remove the 0xCC opcode and restore the 
original instruction in order for the program to continue its 
normal execution. 

Removing the breakpoint is easy but may not be ex¬ 
actly what the user wants. If you remove the breakpoint 
code and resume execution, the breakpoint disappears en¬ 
tirely. If the program later happens to reiterate the same 
instruction, it won't stop the second time. On the other 
hand, if the user has said 'run to the cursor and stop,' 
then the debugger should remove the breakpoint entirely. 
Breakpoints that disappear after the first encounter are 
called soft or once-only breakpoints. Breakpoints that per¬ 
sist are called hard or sticky, and they take more work. 

Before showing how to handle a sticky breakpoint. I'll 
explain what OnBreakpointExceptionO is doing with the EIP 
register. A breakpoint exception occurs when the instruc¬ 
tion pointer in the EIP register advances to an address 
that contains the instruction 0xCC. Executing that instruc¬ 
tion causes the breakpoint exception. By the time the de¬ 
bugger learns of the exception, the EIP pointer has al¬ 
ready advanced one byte past the place where the break¬ 
point was inserted. (Not all CPUs handle breakpoints the 
same way; I'm describing an Intel processor.) In order to 
execute the original instruction that the breakpoint re¬ 
placed, the debugger must restore the displaced byte and 
set the EIP register back. DecrementlPO performs this ma¬ 
chine-specific task. 
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Single-Stepping over a Sticky Breakpoint 

To make a persistent breakpoint, the debugger must 
manage to execute the original instruction and then rein¬ 
sert the breakpoint opcode before the program moves on. 
This is the sequence of events that must occur when the 
debugger receives an exception event for a sticky break¬ 
point: 

• Restore the original instruction. 

• Call ContinueDebugEventO and let the child execute past 
the original instruction. 

• Pause the child program. 

• Reinsert the breakpoint instruction. 

• Continue execution. 

The third step, pausing the child, is the hard one. Sus- 
pendThreadO is not precise enough. Between the time the 
child resumes and the time the debugger calls Suspend- 
ThreadO, the child may already have iterated several more 
times past the instruction where the breakpoint is sup¬ 
posed to be. Fortunately, Intel CPUs support a single-step¬ 
ping mode that automatically generates a trap after exe¬ 
cuting each machine instruction. Here is the revised se¬ 
quence for reinserting a sticky breakpoint: 

• Restore the original instruction. 


• Set single-stepping mode. 

• Call Conti nueDebugEventO and let the child resume exe¬ 
cution. 

• Wait for the subsequent single-step exception to pause 
the child. 

• Reinsert the breakpoint instruction. 

• Turn off single-stepping mode. 

• Continue normal execution. 

Be reassured that single-step mode affects only one 
thread at a time. A bit flag in the CPU turns it on and off. 
Because Windows NT saves and restores the CPU registers 
each time it switches from one thread to another, other 
threads remain unaffected. 

Also in Figure 6 is SetStepFlagO, which turns the Intel 
CPU's single-stepping flag on and off. The single-stepping 
flag is the TF ('trap fault") bit of the EFLAGS register. Get- 
ThreadContextO retrieves the CPU register values for a sin¬ 
gle thread. Stepper tweaks the TF bit and then calls 
SetThreadContextO to push the new setting back into the 
thread state. Next time the system switches to the thread, 
it begins by loading the thread's context and so sets the 
TF bit. 


Figure 7 Code for setting and removing breakpoints 


i* . . 

SET BREAKPOINT 

Write a breakpoint Instruction into the debuggee’s 
code. Save the original instruction first. 

. --*/ 

BOOL SetBreakpointI HANDLE hProcess, PBPNODE pBP ) 

{ 

BOOL bSuccess; 

BYTE byOpcode = BPJPCODE; 
char szMsg[256]; 

_try { 

bSuccess = ReadOpcodethProcess, pBP->pAddress, 
&pBP->0pcode); 
if (bSuccess) 

bSuccess = WriteOpcodethProcess, pBP->pAddress, 
JbyOpcode); 

} _except (EXC EPTION_EXECUTE_HANDLER) { 
bSuccess = FALSE; 

} 

return(bSuccess); 

} 

/*. 

REHOVE BREAKPOINT 

Rerove a breakpoint instruction from the 
debuggee code. (Does not rerove the BPNODE 
structure from the list of breakpoints.) 

. */ 

BOOL RemoveBreakpointl HANDLE hProcess, PBPNODE pBP ) 

{ 

BOOL bSuccess; 

_try { 

bSuccess = WriteOpcodethProcess, pBPOpAddress, 
&pBP->0pcode): 

) _except (EXCEPTION_EXECUTE_HANDLER) { 
bSuccess = FALSE; 

) 

return(bSuccess); 

} 

/*. . 

WRITE OPCODE 

Write a byte into the address space of the given 
process. (Call this to insert breakpoints.) 
. .*/ 


BOOL WriteOpcode( 

HANDLE hProcess, PBYTE pAddress, PBYTE pOpcode ) 
t 

BOOL bSuccess; 

DWORD dwBytes; 

DWORD dwNewFlags, dwOldFlags; 

/* change mem protection in debuggee for writing */ 
bSuccess = VirtualProtectExIhProcess. pAddress. 

1L, PAGE—READWRITE, SdwOldFlags); 
if (!bSuccess) { 

ERROR—MSG(ghMainWnd); 
return(FALSE); 

} 

—try { 

—try { 

/* write new byte to memory */ 
bSuccess = WriteProcessMemorythProcess, 
pAddress, pOpcode, 1L, SdwBytes); 

} -except (EXC EPTI 0N_EX ECUTE_HANDLER) ( 
bSuccess = FALSE; 

} 

) —finally { 

/* restore original protection */ 
dwNewFlags = dwOldFlags; 

VirtualProtectExIhProcess, pAddress, 1L, 
dwNewFlags, AdwOldFlags); 

) 

if (IbSuccess II (dwBytes != 11) 

ERR0R_MSG(ghMainWnd); 
return(bSuccess); 

} 

/*.. . . 

READ OPCODE 

Read one byte from the address space of the given 
process. (Call this to save an instruction 
before over-writing it.) 

. . .*/ 

BOOL ReadOpcode( 

HANDLE hProcess, PBYTE pAddress, PBYTE pOpCode ) 

{ 

BOOL bSuccess = FALSE; 

DWORD dwBytes; 
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Figure 7 continued 


_try { 

bSuccess = ReadProcessMemoryfhProcess, 
pAddress, pOpCode. 1L, SdwBytes): 

} _except (EXCEPTION_EXECUTE_HANDLER) { 
bSuccess = FALSE; 

) 

if (IbSuccess II (dwBytes 1= D) 

E RR0R_MSG(ghMainWnd); 
return(bSuccess); 

} 


/* End of File */ 


Figure 8 Code to manage breakpoints 


i* .. 

TOGGLE BREAKPOINT 

. . .*/ 

BOOL ToggleBreakpoint( UINT uLine ) 

{ 

PBPNODE pBP = NULL: 

BOOL bFound = FALSE; 

if (ICanBreakOnLine(uLine)) 
return!FALSE); 

/* search to end of list for */ 

/* hard breaks on uLine */ 

pBP = FindNextBPbyLineiNULL. uLine); 
while (pBP != NULL) { 
if (!pBP->bOnceOnly) { 
bFound = TRUE; 

ReroveBreakpointiOebuggee.hProcess, pBP); 
DeleteNode(pBP); 
if (pBP == pbpPending) 
pbpPending = NULL; 

Set LinePrefix(pBP-> uLine, PREFIX_BREAK_LINE); 

) 

/* any more breakpoints on this line? *1 
pBP = FindNextBPbyLineiNULL, uLine); 

1 

I* if no breakpoints were found, create one */ 
if UbFound) { 
int iIndex = 8; 

PBYTE pAddress; 

pAddress = GetNextAddressForLine(&iIndex, uLine); 
while (pAddress) ( 
pBP = NewNodeO: 
if (!pBP) return(FALSE); 
pBP->uLine = uLine; 
pBP->pAddress = pAddress; 
pBP->bOnceOnly = FALSE; 
if (!SetBreakpoint<Debuggee.hProcess, pBP)) ( 
DeleteNode(pBP); 
return(FALSE); 

} 

pAddress = GetNextAddressForLinei&iIndex, uLine); 

) 

SetLinePrefix(pBP->uLine, PREFIX_BREAKPOINT); 

1 

return(TRUE); 

} 

/*.... 

RUN TO LINE 

..*/ 

BOOL RunToLinei UINT uLine ) 

{ 

int ilndex = 8; 

PBYTE pAddress; 

PBPNODE pBP = NULL; 

if (ICanBreakOnLineiuLine)) 
return!FALSE); 


//define TFJIT 0x100 
CONTEXT Context; 

Context.ContextFlags=C0NTEXT_C0NTR0L; 

GetTh readContext(hTh read, &Context); 
if (bSetFlag) 

Context.EFlags |= TFJIT; 
else 

Context.EFlags &= -TFJIT; 

The CONTEXT structure contains all the register information 
and must be defined differently for different CPUs. Its 
fields are documented only in winnt.h. 

OnBreakpointExceptionO distinguishes between hard and 
soft breakpoints by examining a Boolean field in the 
breakpoint list node structure. When Stepper inserts a soft 
breakpoint that should disappear as soon as the program 
reaches a certain line, it makes the bOnceOnly field TRUE. 
When the user sets a sticky breakpoint, Stepper makes 
the field FALSE. When Stepper receives an exception from 
a hard breakpoint, it turns the single-step mode on and 
saves a pointer to the relevant breakpoint node in the 
static pbpPending variable. The next debugging event to oc¬ 
cur (assuming the child is single-threaded) will be a single- 
step exception. That's the other signal DoExceptionEventO 
recognizes. It turns off single-stepping, restores the 0xCC 
breakpoint instruction, and continues: 

case EXCEPTION JINGLE JTEP: 

/* end single-step mode */ 

SetStepFlag(Debuggee.hThread, FALSE); 

/* restore the breakpoint we 

just stepped over */ 

if (pbpPending) 

SetBreakpoint(hDebuggee, pbpPending); 
pbpPending = NULL; 
bContinue = TRUE; 
break; 

Before restoring the breakpoint instruction, the pro¬ 
gram confirms that the pbpPending variable still points to a 
BPNODE structure. That's in case the user deleted the break¬ 
point while the program was suspended. The bContinue 
flag is passed back to the main debugging event routine, 
where it tells the program not to suspend execution for 
this exception. The program keeps running without the 
user ever realizing a second exception occurred. 

The processor's single-step mode comes in very handy 
for restoring persistent breakpoints. Its usefulness might 
suggest an easier way for Stepper to make the program 
stop on source code lines. Stepper could keep the child 
running permanently in single-step mode, watch the in¬ 
struction pointer, and pause whenever it reaches an ad¬ 
dress that corresponds to a source code line. That way 
Stepper would never have to insert and remove any 
breakpoint instructions. 

This works but is unacceptably slow. The number of 
machine instructions corresponding to a single source 
code line may be quite high. The instructions may step 
into system code, in practice, debuggers never use this 
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logical algorithm for stepping through source code. Even 
the brute-force method of silently setting invisible break¬ 
points on all the program's lines and running from one to 
the next is usually faster. (Stepper lets you do that, by the 
way. One of the menu commands sets all the possible 
breakpoints.) 

Some of the processors that run Windows NT lack sin¬ 
gle-step support. RISC chips in particular avoid single-step- 
ping because it slows all instructions. To restore a sticky 
breakpoint on these machines, most debuggers disassem¬ 
ble the instruction where the breakpoint occurred in order 
to discover which instruction will execute next. The debug¬ 
ger then sets a soft break at the next instruction, runs to 
the soft break, puts the sticky breakpoint back behind, re¬ 
moves the soft break, and continues. 

Setting and Removing Breakpoint 
Instructions 

Now I can show code that sets and removes break¬ 
points. The breakpoint routines also initialize new break¬ 
point nodes for the linked list. Here's the structure that 
defines each breakpoint node: 

typedef struct bpnodef 
/* source line of bp */ 

UINT uLine; 

/* code address of bp */ 

PBYTE pAddress; 

/* displaced instruction */ 

BYTE Opcode; 

/* TRUE for soft break */ 

BOOL bOnceOnly; 

/* next node in list */ 
struct bpnode *pNext; 

} BPNODE; 

typedef BPNODE *PBPN0DE; 

Setting a breakpoint means modifying the code of an¬ 
other program, and the protected address space that NT 
provides every process is designed to prevent such modifi¬ 
cation. Besides isolating programs from each other, the 
system protects the pages of physical memory where a 
program's executable image resides, so that any attempt 
to write there produces an access violation. To set a 
breakpoint you must change the page protection at the 
given address, save the original instruction, write a break¬ 
point opcode, and restore the protection. Under 16-bit 
Windows, the TooIHelp functions MemoryReadO and Memory- 
UriteO handle these issues for you, but under Windows 
NT you must code your own solutions. 

Figure 7 shows the four procedures I use to set and 
remove breakpoints: UriteOpcodeO, ReadOpcodeO, SetBreak- 
pointO, and RemoveBreakpointO. UriteOpcodeO overwrites a 
single byte at any address in the child's address space. It 
calls VirtualProtectExO to change the page protection and 
UriteProcessMemoryO to put a new byte there. A termina¬ 
tion handler ensures that the protection is restored to its 
previous state even if an exception occurs. ReadOpcodeO is 
simpler because the normal protection state of code pages 


Figure 8 continued 


pAddress - GetNextAddressForLinediIndex, uline); 
if (pAddress ■* GetIPAddress(Debuggee.hThread)) 
return(TRUE); 

pBP = NewNodeO; 
if (!pBP) return(FALSE); 
pBP->uLine * uline; 
pBP->pAddress = pAddress; 
pBP->bOnceOnly = TRUE; 

if (ISetBreakpointfOebuggee.hProcess. pBP)) { 
DeleteNode(pBP); 
return!FALSE); 

} 

/* do not show breakpoint glyph on screen */ 

I* initiate the Run command */ 

FORWARD_WM_COWiAND(ghMainWnd, CMDJUN, NULL. 

8. SendMessage); 
return(TRUE); 

) 

/*. . 

SET ALL BREAKPOINTS 

. .*/ 

BOOL SetAUBreakpoints! void ) 

{ 

PBPNODE pBP; 
int i; 

for (i=0; 1<iBreakLineCount; i++) { 
pBP = NewNodeO; 
if (IpBP) return!FALSE); 
pBP->uLine = BreakLines[1]; 

pBP->pAddress = Debuggee.pStartAddress + LineAddressti]; 
pBP->bOnceOnly * FALSE; 
if (!SetBreakpoint(Debuggee.hProcess, pBP)) { 

DeleteNode(pBP); 
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Figur© 8 continued 


return(FALSE); 

} 

SetLinePrefix(pBP->uLine. PREFIX BREAKPOINT); 

} 

return(TRUE); 


/*. 

CLEAR ALL BREAKPOINTS 

*/ 

BOOL ClearAl1 Breakpoints! void ) 

{ 

PBPNODE pTemp. pBP; 

BOOL bSuccess = TRUE; 

pBP = FirstNodeO; 
while (pBP && bSuccess) { 

bSuccess = RemoveBreakpoint(Debuggee.hProcess. pBP); 
if (bSuccess) { 

/* remove the breakpoint glyph */ 
if (pBP->uLine != 0) 

SetLinePrefix(pBP->uL1ne, PREFIX_BREAK_LINE); 

/* remember not to restore bp after */ 

/* next single-step */ 
if (pBP == pbpPending) 
pbpPending = NULL; 

pTemp = NextNode(pBP); 

DeleteNode(pBP); 
pBP = pTemp; 

) 

} 

return(bSuccess); 

} 

/* 

CAN BREAK ON LINE 

Return TRUE if it is possible to set a breakpoint 
on the given line of source code. 

*/ 

BOOL CanBreakOnLine( UINT uLine ) 

{ 

int 1 = 0; 

BOOL bFound = FALSE; 

while ((i<iBreakLineCount) && IbFound) 
bFound = (uLine == BreakLines[i++]); 

return(bFound); 

} 

/*. 

GET NEXT ADDRESS FOR LINE 
Starting from the given array index, search for 
the next machine code address associated with 
a given line number. Use this function to find 
all the stoppable instructions that fall on a 
particular source code line. 

.*/ 

PBYTE GetNextAddressForL1ne( PINT plndex, int ILine ) 

{ 

PBYTE pAddress = NULL; 

BOOL bFound = FALSE; 
int iIndex = *plndex; 

ilndex = max(ilndex, 0); /* assert *plndex >= 0 */ 

while (IbFound && (Ilndex < iBreakLineCount)) 
bFound = (BreakLines[1Index++] == iLine); 

if (bFound) { 

*plndex = ilndex--; 

pAddress = LineAddressfiIndex] + Debuggee.pStartAddress; 

} 

return(pAddress); 


/*. 

MARK ALL BREAK LINES 

Place a PREFIX_BREAK_LINE character in front of 
each source line where a breakpoint may be set. 

*/ 

void HarkAl1BreakLines( void ) 

{ 

int i; 

for (i=0; 1<iBrea kLineCount; i++) 

SetLinePrefix(BreakLines[13, PREFIX_BREAK_LINE); 

} 

/* End of File */ 


allows read access, so a single call to ReadProcessMemoryO 
accomplishes the task. SetBreakPointO calls both of the 
other routines. First, ReadOpcodeO returns the child's original 
instruction which must be saved, then UriteOpcodeO inserts 
the 0xCC byte that causes an INT 03H exception. 

Other Breakpoint Functions 

Once you have the low-level routines for setting break¬ 
points, the linked list for maintaining a list of breakpoints, 
and the basic program structure that lets the debugging 
thread respond to commands from the user, Stepper's 
other breakpoint functions fall into place. SetAllBreak¬ 
points!) reads the hard-coded arrays of line number infor¬ 
mation and creates breakpoint list nodes for each address 
stored there. ClearAllBreakpointsO walks the linked list of 
breakpoints and restores all the original instructions, delet¬ 
ing each list node it passes. ToggleBreakpointO searches 
the existing list to determine if any breakpoint exists for 
the current line. If so, it removes the breakpoint. If not, it 
creates one. These routines appear in Figure 8. 

Stepper greatly simplifies its task by assuming that the 
child process never creates any extra threads. A full-fea¬ 
tured Win32 debugger would need to let the user set 
breakpoints that interrupt only a single thread. It would 
monitor CREATE_THREAD_DEBUG_EVENT signals and maintain a 
list of all the current threads. Each thread might have its 
own linked list of breakpoints, or each breakpoint node 
might have a field to store a thread ID. To accommodate 
conditional breakpoints which occur only when some con¬ 
dition is true, the BPNODE structure would also need to re¬ 
cord the condition associated with a breakpoint. 

One complication that Stepper does partially accommo¬ 
date is the possibility of several breakpoints existing on a 
single line of source code. Consider how Borland's com¬ 
piler encodes the for loop in foo.exe: 

#foo#7: for (i=0; i<3; i++) 

:00410053 31FF xor edi.edi 
:00410055 EB10 jmp F00.00410067 
#foo#8: printf("%d\n\r", i); 

:00410057 B86C004300 mov eax,0043006C 
: 0041005C 57 push edi 
: 0041005D 50 push eax 
:0041005E E8450C0000 call printf 
:00410063 83C408 add esp,00000008 
#foo#7: for (i=0; i<3; 1++) 

:00410066 47 inc edi 
:00410067 83FF03 cmp edi,00000003 
:0041006A 7CEB jl #foo#8 (00410057) 

Addresses 0x00410053 and 0x00410066 both contain instruc¬ 
tions that correspond to line 7 of the source code, with 
the code for line 8 falling in the middle. (Microsoft codes 
the for loop differently, as you can tell from the data in 
Table 2, where only one address falls on line 7.) In the 
first draft of Stepper, if I asked to set a breakpoint on line 
7, the debugger found the first address for line 7 and 
stopped, setting a breakpoint there only. I expected the 
program to stop every time it returned to the top of the 
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for loop, but in fact it stopped only the first time through 
the loop. That's why ToggleBreakpointO now searches for 
all the addresses that correspond to a single line when 
setting or removing any breakpoint. 

A single line may also have to bear several breakpoints 
if the user asks for them. Even in Stepper the user might 
toggle all the breakpoints on, put the cursor on the first 
breakpoint, and choose 'Run to cursor' from the Run 
menu. The Run-to-cursor command inserts a soft break¬ 
point where there is already a hard one. Stepper solves 
this problem by making NewNodeO always insert new 
nodes at the beginning of the list, so that FindBPbyAd- 
dressO always finds the most recent breakpoint first. That 


way the debugger never accidentally removes a hard 
breakpoint by mistake. In a full-featured debugger the 
situation becomes more complicated if the user, for exam¬ 
ple, sets on one line a thread-specific hard break and a 
conditional break for any thread, and then single-steps 
through the code. At each stop the debugger must find 
and evaluate all the relevant breakpoints. 

Conclusion 

The Win32 debugging API imposes a basic program 
structure on any Windows NT debugger. A UaitForDe- 
bugEventO loop must poll for debugging events, and an 
interactive debugger needs synchronization objects to co¬ 
ordinate command events from the 
user interface with debugging events 
from the system. The Win32 API 
gives a debugger much of the control 
it needs over any process it launches, 
but it lacks the commands for ma¬ 
chine-specific features such as break¬ 
points and single-step mode. A de¬ 
bugger aimed at all the possible NT 
platforms must still provide a toolbox 
of machine-specific routines such as 
Stepper's SetStepFlagO, GetlPAd- 
dressO, and DecrementIPO. 
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Ron Burk 


The spring version of Software Development has always been my favorite 
conference for programmers. In a moment of hubris, I signed up to teach a 
class this year. Unfortunately, but predictably, that meant that I spent a lot of 
time holed up in my hotel room working on my talk. In fact, I ran into Gen 
Kiyooka (another author and speaker at the show) at the San Jose Kinko's; I 
think we each sort of wondered what the other was doing there, but it turned 
out we were both trying to get our class handouts printed at the last minute. 
Despite the limited time I had, I got to see some parts of the conference, as I 
will relate in this report. As always, I apologize in advance to the many ven¬ 
dors whose products I did not get to check out. Software Development is a big 
show, and even if I spent the entire time getting product demonstrations, I 
would never get to all of them. 


Parties! 


Of course, the most important news to report on at SD is the parties, though 
this year was a bit of a dud. Pre-show publicity had advertised a Borland 'ca¬ 
sino night' (a great party of shows gone by, consisting of real, Vegas-style 
gambling tables), but instead we got shuffled over to a sports bar. This actually 
turned out to be fairly fun, since most of the games were free all night. Borland 
wins again this year in the category of best party. Microsoft, in belt-tightening 
mode, advertised a party of cheap beer and pizza; they win the award for truth 
in advertising. Watcom, as usual, delivered a product announcement and party 
consisting of T-shirts, a bit of live entertainment, and a buffet; stodgy, but reli¬ 
able. Symantec held a product announcement and party; I missed the an¬ 
nouncement but wandered by at 9:30pm, a full two hours before the party was 
slated to be over and found the room being dismantled by workmen; appar¬ 
ently the party was so intense that everyone was quickly exhausted and had 
to leave. Inexplicably, I did not receive an invitation to the Microsoft Systems 
Journal party. 
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Probably the most entertaining evening was offsite and 
not open to the public. I got to go to nearby Silicon 
Graphics and try out their fighter plane simulator, consist¬ 
ing of a mock cockpit sitting in front of a horizon three 
projected screens wide, with full stereo sound. It was 3D 
rendered in real time, realistic enough that just waggling 
the stick back and forth a few times made my stomach 
instantly queasy. Thanks to Mark Young, Mark Stadler, 
and friends for sneaking us in and firing up a few hun¬ 
dred thousand dollars worth of hardware for us to play 
with. It's hard to go back to 800x600, 16-color Windows 
GDI after you sit in front of a Silicon Graphics machine for 
an hour or two. 


Products! 

In past years, Software Development has been the 
show at which Borland and Microsoft made their juiciest 
programming announcements and entertained the masses 
with fierce competition (and price cuts!). Even though the 
giants were more subdued this year (Borland was rolling 
out their new C++ for OS/2), there was lots of action 
among the smaller players. 

Utah 

My first stop was to see Utah, a new GUI design tool 
from ViewSoft. These folks have been holed up for some 
years working on this tool, and this was their first chance 
to demonstrate the nearly-ready 
(they should be shipping by the time 
you read this) product at a show. 
Utah is packed with many more fea¬ 
tures than I could see and under¬ 
stand in a one-hour demo, but I will 
try to hit the highlights. 

Like many GUI design tools, Utah 
gives you an abstracted API that, if 
you stick to it, will port to other plat¬ 
forms (in order, ViewSoft plans to 
support Windows, Windows NT, 
Macintosh, and Motif). Like some GUI 
design tools, Utah offers 'geometry 
management,' i.e., the ability to spec¬ 
ify relationships between screen 
items so that, for example, a dialog 
box can have a sizable frame and do 
intelligent things (such as grow or 
shrink the size of a child edit win¬ 
dow) when the user resizes it. 

If you've been following my Prac¬ 
tical C++ column, you know that I 
have specific ideas about what a GUI 
design tool should offer. Utah ap¬ 
pears to implement several of the 
concepts I find most appealing. Utah 
strongly encourages a separation of 
user interface code from application 
code. The basic idea is that you de¬ 
fine via C++ class members the data 
that your user interface needs to be 
able to manipulate (for example, an 
integer or character string). As a 
separate step, you connect one of 
many possible Utah user interface 
objects (such as a scroll bar or edit 
control) to that data. Utah includes 
many such objects (it calls these 
'views') and gives you a lot of con¬ 
trol over their appearance; you can 
also create your own views if the in¬ 
cluded set is not sufficient. The user 
can manipulate the view to alter the 
data in your class member. Con¬ 
versely, if you alter the class member 



SEE what no 
, other Windows 
HI debugger can 
show you. “WinScope 
lurks on your desktop and 
spies on messages, API calls, 
hooks, and more." Watch a 
single window, module, func¬ 
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system, or anything in 
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wide view lets it capture what 
other debuggers can’t even 
see! 

8 THINK of WinScope 
as “a super API spy on 
steroids.” Trace virtually any 
Windows API, with parameters. WinScope’s 
growing base of 2,000+ APIs (200+ un¬ 
documented) makes it the most compre¬ 
hensive API debugger available. And its 
powerful scripting feature lets you add 
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(e.g., foo.XPos = 25;), the view will change (e.g., the string 
in the edit control changes, or a scroll bar moves). 

The key here is that even if you write your own cus¬ 
tom user interface code in the form of a Utah view, user 
interface code is kept cleanly separated from the rest of 
your application. That separation is crucial for portability 
and helps keep your application code from being depend¬ 
ent on Windows or even Utah itself. That separation also 
gives you the flexibility to design and alter the user inter¬ 
face without affecting application code. Utah also lets you 
create programs that can allow the user change the user 
interface style at runtime. 

Utah supports a kind of style inheritance. You can de¬ 
fine objects such as dialog child controls whose styles are 
set to be whatever the style of the enclosing object (such 
as the dialog box) is. This gives the user interface designer 
the ability to change styles quickly, and even to build re¬ 
usable collections of user interface objects that can be 
plugged into a new dialog without having their styles set 
individually. (See last month's Practical C++ for a discus¬ 
sion of how WUIMAN implements a similar concept.) 

At $1,495, with technical support costing $350 per 
year, Utah is not a casual purchase. ViewSoft is going to 
have a tough time communicating the technical advan¬ 
tages of their product and wresting programmers away 
from competing products or even their favorite compiler's 
application framework. All these tools require significant 
effort to learn and use effectively, so once you've bought 
into one of them, it's going to take a compelling reason to 
change. Still, I think this product brings some fresh ideas 
(fresh in the PC world at least) to the table and deserves 
inspection. Utah comes with a 30-day, money-back guar¬ 
antee, with no questions asked, so you can evaluate it 
free of risk. For more information, contact ViewSoft, Inc., 
60 North 300 West, Provo, UT 84601, (801) 377-0787; 
fax (801) 377-0788. 

ProtoGen+ Client/Server Suite 

ProtoView has been a player in the GUI design tool 
market for some years now. At this show, they were fea¬ 
turing the ProtoGen+ Client/Server Suite, a $995 collection 
of tools (with the ProtoGen+ Workbench at the center) 
that lets you interactively design and modify user inter¬ 
faces for Windows applications with database support. 
The $995 package includes the following products (all 
available separately): ProtoGen+, SQLView, DataTable 
Spreadsheet Control and DataTable Lens Object, the Win- 
Control library, and the Report Writer Visual Coder. 

The ProtoGen+ Workbench gives you a visual way to 
create and modify your Windows application's user inter¬ 
face. You can test aspects of the user interface interac¬ 
tively from within the product, and it can generate code 
compatible with compilers from Microsoft, Borland, Sy¬ 
mantec, and Watcom. As usual, if you follow their guide¬ 
lines, you can modify the generated code without losing 
the ability to later modify the user interface and regener¬ 
ate the code to implement it. 

SQLView gives you visual access to databases, via 
ODBC and Q+E drivers. You can select tables, automat¬ 


ically create forms, and link screen fields to database col¬ 
umns. The DataTable Lens object is a spreadsheet-like 
control that makes it easy to scroll through database re¬ 
cords and make changes, additions, or deletions. It uses 
virtual memory to support large databases and provides 
an API you can use to customize its behavior. 

The WinControl library offers 14 Windows controls, of¬ 
fering 3D looks and input validation (currency, dates, nu¬ 
merics). The Report Writer Visual Coder gives you access 
to the report writing features of Crystal Professional Re¬ 
port Writer v3.0 (included with the package). You can see 
your reports live in test mode and then generate the code 
for Crystal Report. 

For more information, contact ProtoView Development 
Corporation, 353 Georges Road, Dayton, NJ 08810, (800) 
231-8588 or (908) 329-8588; fax (908) 329-8624. 

C++/Views 

You couldn't swing a cat at SD '94 without hitting a 
GUI development tool vendor. My last stop in this cate¬ 
gory was at Liant Software, for a demonstration of the 
latest version of their C++/Views class library. The usual 
features are here: they offer an abstract API, and sticking 
to it gives you portability across Windows, OS/2, Motif, 
Macintosh System 7, and DOS character mode. You get the 
look and feel of whichever target platform you recompile on. 

The new version of C++/Views adds a visual tool for 
"painting" the user interface, and a portable resource for¬ 
mat that makes the objects you create (dialogs, buttons. 
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etc.) portable across platforms. I expected to see just a 
slight superset of a dialog editor, but Liant's new visual 
tool sports geometry management, and a nifty visual in¬ 
terface for specifying the relationships between child con¬ 
trols and how they should change as you resize a dialog 
or move a pane border (which they call a 'sash'). 

C++/Views v3.0 costs $749 for Windows ($149 for up¬ 
grades), $999 for OS/2 Presentation Manager ($179 for 
upgrades), $1,999 for UNIX/Motif ($279 for upgrades), 
$1499 for the Macintosh, and $499 for DOS (text mode). 
For more information, contact Liant Software, 959 Con¬ 
cord St., Framingham, MA 01701-4613, (508) 872-8700; 
(508) 626-2211. 

FrontRunner 

Phar Lap is making a foray from their mainstay market, 
DOS extenders, to offer FrontRunner, a replacement for 
Program Manager. I've been using the beta version of this 
product as my shell for some months now, having dis¬ 
carded both Program Manager and Dashboard. I can't say 
that FrontRunner has one big, compelling feature that 
won me over; rather, it's handful of features that sound 
trivial but that save me time each and every day. 

By virtue of its DOS extender experience, Phar Lap has 
the expertise to integrate FrontRunner's support for DOS 
shells better than other Windows shells. With FrontRunner, 
my DOS box runs in a real Windows window just as with 
Program Manager, but now output that scrolls off the top 
of the screen can be scrolled back down with the scroll 
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bar. Program Manager offers a tortured interface for mov¬ 
ing data between the DOS box screen and the clipboard; 
with FrontRunner, I can just press the mouse button and 
drag to copy text to the clipboard, or click the right mouse 
button to copy the clipboard's contents into the DOS box's 
input stream. This sounds like a trivial improvement, but 
after you use it a few days, it is very painful to go back to 
the old way of doing things. Another trivial-sounding fea¬ 
ture is the fact that I can execute Windows applications 
from the DOS prompt. Since I do a lot of program devel¬ 
opment from the DOS prompt anyway, 1 use this feature 
dozens of times a day, and save a lot of time switching 
between DOS and Windows. 

I am a big fan of extensibility, and FrontRunner offers a 
good deal of that through its status bar interface. The 
product comes with several status bar utilities, such as a 
disk space monitor, but you can write your own as well 
and then use FrontRunner's status bar configuration dialog 
to place it on the status bar. For example, FrontRunner 
comes with a command history menu dialog that lets me 
quickly select from recent DOS box commands. I don't 
happen to care for the user interface it uses, but since this 
is a status bar utility, I can implement my own version of 
DOS command history that gives me any interface that I 
can think of! 

The product has many other features, such as DOS 
batch commands that can give your batch files visual 
front ends, and the ability to create sets of icon-based 
launch bars (I create one set for each Windows project I 
am working on - switching between them is as easy as 
clicking on a menu). FrontRunner will cost $139 and 
should be shipping by the time you read this. However, 
you can get a free demo of FrontRunner from Phar Lap by 
calling (800) 292-9622. At that price, you can't lose, so try 
it out. For more information, contact Phar Lap Software, 
Inc., 60 Aberdeen Avenue, Cambridge, MA 02138, (617) 
661-1510; (617) 876-2972. 

Bounds-Checker v2.0 for Windows 

I was surprised to be reminded at this conference that 
there are still C and C++ Windows programmers out there 
who don't have Bounds-Checker for Windows (BCHKW) or 
even know what it is good for. BCHKW is good for more 
than one thing, but let me try to sum up the most impor¬ 
tant thing you should know about this product. 

In its finite wisdom, Microsoft created an operating sys¬ 
tem that forces applications to manage its internal re¬ 
sources, and then dies when they fail to do so properly. 
Thus, forgetting to free up each and every little GDI object 
in your program can cause Windows to eventually grind 
to a halt and die (it doesn't matter if you have 64Mb of 
memory - Windows still has 64Kb restrictions!). How will 
you detect and locate the resource leaks in that 500,000- 
line C++ program you are getting ready to ship? You use 
BCHKW to load and execute your program, then when 
your program terminates, BCHKW pops up and shows you 
every object that did not get freed up, along with the 
source code that created that object. That's right, it 
shows you the exact line of C/C++ source code that is 
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the cause of the resource leak! There is simply no other 
product on the market that automates resource leakage 
detection (one of the most common deadly Windows pro¬ 
gramming bugs) to this degree. If your company creates 
Windows applications, somebody better have a copy of 
BCHKW around to test them with. 

The latest version of BCHKW is 2.02a, which just ar¬ 
rived as I was writing this report. Borland C++ v4.0 uses a 
new debugging format, which was incompatible with 
BCHKW. The new version of BCHKW now works with Bor¬ 
land C++ v4.0, which is a great relief to me, since I use 
BCHKW to help verify the code we publish in the maga¬ 
zine. Now I can resume using it with Borland and Mi¬ 
crosoft compilers. It should also work with Symantec, 
which claims compatibility with the Microsoft debugging 
information format, but I have not had 100 percent suc¬ 
cess with that. BOUNDS-CHECKER v2.0 for Windows costs 
$249. For more information, contact Nu-Mega Technolo¬ 
gies, Inc., P.O. Box 7780, Nashua, NH 03060-7780, (603) 
889-2386; fax (603) 889-1135; BBS (603) 595-0386. 

Blue Sky 

Blue Sky makes WindowsMAKER Professional, yet an¬ 
other venerable player in the GUI design tool market. 
With version 5.5, Blue Sky is bundling support for OWL, 
ANSI C, and MFC code generation into a single package 
for $995. The new version sports a 3D user interface and 
lets you design 3D user interfaces that incorporate 256- 
coior bitmaps, scrollable dialog boxes, and more. 


The Multimedia Extended Functionality Module (EFM) 
lets WindowsMAKER Professional v5.5 customers add 
voice, sound, or video to menus, buttons, bitmap buttons, 
and graphics. It supports .avi files for video and .wav for 
sound and voice. The Multimedia EFM includes the Video 
for Windows vl .1 runtime, enabling users to run video on 
a normal VGA screen. For a limited time, Blue Sky is in¬ 
cluding the $99 Multimedia EFM with any purchase of 
WindowsMAKER Professional v5.5. 

Blue Sky's visual WinHelp development tool, RoboHelp, 
can also make use of multimedia. Multimedia WinHelp 
costs $199 ($99 for registered users of RoboHELP) and of¬ 
fers the same features that the Multimedia EFM provides 
to WindowsMAKER Professional. RoboHelp v2.6 is compat¬ 
ible with both Word for Windows v6.0 and v2.0. For more 
information, contact Blue Sky Software Corporation, 7486 
La Jolla Blvd., Suite 3, La Jolla, CA 92037, (800) 677-4946 
or (619) 459-6365; fax (619) 459-6366. 

Bug Tracking Heats Up 

A new product category has arisen in Windows devel¬ 
opment tools - bug tracking software. I've known about 
this category for a while, but this show was the first time 
I've tried to look at the various products. I sort of ex¬ 
pected rigid, inflexible tools that force you to enter and 
track bug reports via fixed forms and reports. Instead, I 
was happy to see that vendors have taken the intelligent 
approach of building bug tracking software on top of gen¬ 
eral-purpose databases. The result is that you have a 
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great deal of control over what data to log and what re¬ 
ports you want to see. Network-aware versions can offer 
integrated mail services, for example, making sure that de¬ 
velopers are notified via email of bugs reported in their 
particular sections of code. 

At the high end of this product category. Defect Control 
System v2.0a is a bug-tracking system that offers detailed 
security features; administrators can control who can see 
and modify individual fields. Email support lets you auto¬ 
mate notification of bugs and bug fixes. The product also 
provides queries and graphical reports, such as bar charts 
and line graphs. DCS v2.0a costs $495 per license, with 
volume discounts available. For more information, contact 
The Software Edge, 5526 N. Academy Blvd., Suite #204, 
Colorado Springs, CO 80918, (719) 598-3713; FAX (719) 
598-3970. 

Track Record, from UnderWare, Inc., targets smaller 
workgroups and individual developers, and is aimed at a 
variety of development tasks, not just bug tracking. For 
example, you can use Track Record for to-do lists, schedul¬ 
ing meetings, customer databases, and so on. Track Re¬ 
cord costs $159 per user. For more information, contact 
UnderWare, Inc., 321 Columbus Ave., Boston, MA 02116, 
(800) 343-7308. 

BugBase for Windows, from Archimedes Software, is a 
software bug tracking tool that helps you record, classify, 
assign, and report software bugs or change orders. The 
network version adds multi-user access, record locking, se¬ 
curity, email integration, and support for version control 
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software. An administrator can define all bug classification 
types and subtypes, and each user ID can be assigned 
access privilege levels to the bug database. BugBase sup¬ 
ports database queries and produces reports on screen, in 
printouts, or in pie-chart formats. The package also pro¬ 
vides for work-around information and actual-versus-esti- 
mate analysis. Archimedes BugBase for Windows costs 
$349 for the single-user version and $1295 for the net¬ 
work version. For more information, contact Archimedes 
Software, Inc., 2159 Union Street, San Francisco, CA 
94123, (41 5) 567-4010; fax (41 5) 567-1318. 

Gung-Ho Graphics 

Visigenic's Signature graphics C++ class library is a 
high-end product, both in price ($2,900 per Windows de¬ 
veloper, plus runtime royalties) and in features. The library 
supports both vector and raster (bitmap) graphics and is 
designed to be portable (initially for Windows, with UNIX 
and Mac support planned). My take on all this is that you 
basically have a 2D vector library, with the ability to also 
insert your own code and data (bitmaps) at the point 
where the 2D objects are rendered into bitmaps to be dis¬ 
played on the screen. 

Flowever, the support inside the library is far from ba¬ 
sic. We're talking anti-aliasing and texture mapping, and 
all the rendering is redefinable, so you can define your 
own convolutions if the supplied operations (triangle, 
Gaussian, and LaPlacian filters, sharpen, soften, etc.) are 
insufficient. If you prefer to work in some funky color 
model of your own devising, you can define your own 
pixel type (the package includes pixel types for RGB, 
CMYK, and FISV color models). If you need very flexible, 
very advanced graphics manipulation in your application, 
check out this product. For more information, contact 
Visigenic, 1425 Corporate Center Parkway, Santa Rosa, CA 
95407-5434, or (707) 576-7722; fax (707) 576-7731. 

Summary 

Now is the time to start hitting up your manager to 
send you to Software Development '95. There is always a 
great lineup of classes; in fact, you will probably find that 
some time slots have two or three classes you want to 
attend. The trade show gives you a chance to see demos 
of the latest software, and the hands-on area gives you a 
chance to try things out yourself to see if it is as easy as 
the vendor made it look. You will get a chance to rub 
shoulders with the movers and shakers of our industry, 
and make contacts that can be useful to you the rest of 
the year. The parties are great, too, but don't mention that 
until after your manager books your travel! □ 
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WinScope 

Jeff Cogswell 


Life isn't easy. If you've ever tried to trace through a 
piece of software that lacks source code and symbols - 
meaning you looked at the assembly code - then you 
know what I mean. Or, perhaps you've become frustrated 
upon receiving a GP Fault message, and finding that the 
standard post-mortem debuggers didn't provide quite 
enough clues to solve the problem. Fortunately, there are 
some products that can help in these areas. One such pro¬ 
gram is WinScope, by The Periscope Company. 

WinScope is a non-intrusive, event-capturing program. 
This means that, unlike debuggers such as Turbo Debug¬ 
ger or CodeView, once you start WinScope running, it qui¬ 
etly sits in the background, recording the activities of the 
program being debugged or reverse-engineered. Win¬ 
Scope can log DLL calls, messages, and hooks. It can be 
set up to activate a debugger on certain events - not cer¬ 
tain locations in code, but certain events, such as the re¬ 
ceipt of a message or the call of a DLL function. 

There are many uses for WinScope: one is to log 
events performed by the program you are writing, for 
help in debugging. Another possibility is to monitor the 
actions of a third-party piece of software. This is handy for 
reverse-engineering the software, or simply discovering 
which DLL calls it makes. 

Using WinScope 

Installation is quick and easy; WinScope uses a stand¬ 
ard packaged installation program and took only about a 
minute and a half to install. The product comes on a sin¬ 
gle 3-1/2-inch floppy disk. 


Product Information 


WinScope vl.l 

The Periscope Company, Inc 
1475 Peachtree St, Suite 100 
Atlanta, GA 30309 
(800) 722-7006 or (404) 888-5335 
FAX (404) 888-5520 


Price: $149, with a 60-day money-back guarantee, vl.2 
update is available to registered users for $25 (free if 
you purchased within 60 days of the release date). Sup¬ 
port is available via CompuServe [GO PERISCOPE], The 
Periscope Company's BBS [(404) 888-5522], or the sup¬ 
port hotline [(404) 888-5550]. 

Summary: A non-intrusive debugger that provides the 
ability to log not only window messages, but also calls 
to DLLs by any Windows application. It handles the 
standard Windows API functions automatically, but you 
can use its script language to extend that capability to 
custom DLLs. 


Jeff Cogswell is a Windows programmer and writer living in Cary, NC, near the Research Triangle Park. He is currently working on a 
book for Waite Group Press. 
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There are two ways to trace applications using Win- 
Scope. The first is called Load and Go. You pull down the 
File menu and choose Load Application. You specify the 
.exe you want to trace via a file dialog box, then select a 
checkbox labeled 'Load and Go'. When you press the OK 
button, WinScope minimizes while the program you re¬ 
quested loads. 

After your program loads, you use it in the normal 
way. When you're finished, you can return to WinScope 
and choose the Stop menu item to stop tracing. (A Stop 
menu item is also available on the system menu while 
WinScope is minimized.) After stopping the tracing, you 
can examine the events by looking at two of WinScope's 
child windows - Trace and Parameters. 

The Trace window (see Figure 1) 
has scroll bars and lists all the mes¬ 
sages by the usual names (such as 
UM_COMMAND), calls to DLLs by their 
usual names (such as CreateMindouO), 
and hooks by their usual names. 

When you click on one of the lines 
in the Trace window, the Parameters 
window lists the far parameters, if 
any, for the event. This includes the 
IParam of message events, or any far 
parameters for DLL function calls. For 
pointers to strings and structures, the 
Parameters window will also show 
the data being pointed to. For large 


blocks of memory, unfortunately, it shows only the 
pointer. 

You can search for specific events inside the Trace win¬ 
dow by using the Find feature. This works essentially like 
a find feature in a standard text editor: you are presented 
with a dialog, and you type in the search text. You then 
press the Find Next button, and the next occurrence of the 
text in the Trace window scrolls into view. The dialog will 
remain on screen, so you can then find the next occurrence. 

You can also save the Trace buffer to a text file; when 
you do, the far parameters can be mixed in with their 
respective events. When I've done this, and printed the 
resulting file. I've found it helps to print it with a very 
small (i.e., 6 or 7 point) font, because the traces often run 
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10 or so pages, even if I'm only tracing a small applica¬ 
tion for a short time. 

The second way of tracing applications using WinScope 
is to start an application manually (from Program Man¬ 
ager, for example) and then specify which events you 
want to log. To accomplish this, you use the rest of Win- 
Scope's child MDI windows. One of these windows, the 
Windows List, lists all the windows currently existing in 
the system (in a similar hierarchical manner as Borland's 
WinSight). You select which windows you want to trace by 
clicking on them in the list. You can select multiple win¬ 
dows, and if you hold down the mouse and slide it up or 
down, you can make multiple selections. 

After that, you choose which program modules these 
windows correspond to. You do this by means of another 
window, which lists ail the currently loaded modules, in¬ 
cluding .exes and .dlls. Note that although you need not 
choose a window, you must choose a module to trace. 

Next, you choose the events to log. There's a set of 
MDI windows, which I'll call the event-selection windows, 
for this purpose (see Figure 2). One window is for mes¬ 
sages; it lists all the standard Windows messages, includ¬ 
ing undocumented Windows messages, as well as mes¬ 
sages for the standard controls (such as LB_ADDITEM). You 
can add your own messages for other custom controls; I'll 
talk about this later in the "Scripting* section. There's also 
a window for choosing DLL calls you wish to monitor; this 
window includes all the standard Windows API functions, 
such as CreateMindowO and SendMessageO. As with mes- 
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sages, you can also add your own. In addition, you can 
monitor system hooks as they occur, using yet another 
window which lists the hooks. Note that you can skip any 
of these altogether; that is, if you don't want to log any 
messages, you can just not choose any. Or, if you don't 
want to log functions or hooks, you can simply not 
choose any. 

Finally, there's a window for setting breakpoints to oc¬ 
cur in response to any event in the event-selection win¬ 
dows. This is handy, because you can set, say, a break¬ 
point to occur on mouse-down events. Then, when you 
begin tracing and a mouse-down event occurs, WinScope 
will trigger a debugger, if one's running, through the INT 
03h mechanism. This works out quite nicely, because to do 
the same sort of thing in CodeView requires a conditional 
breakpoint, which slows things down drastically. Again, 
you need not set any breakpoints if you don't need any. 

A couple buttons at the top allow you to clear out all 
your selections in any window, or choose all the items in 
the window, such as all messages in the Message List win¬ 
dow. After making all of your selections, you then choose 
the Start menu, and, as before, WinScope will minimize 
and begin logging events. 

The program is surprisingly fast. When I first heard of 
it, I figured it would slow my system down almost to a 
halt. But it really doesn't, so long as you don't use a sec¬ 
ondary monitor to watch messages and you keep Win¬ 
Scope minimized during tracing. In fact, when WinScope is 
logging a trace, you hardly know it's running. Because of 
that, I've found it handy to just have it running all the 
time, and whenever I run a program I'm developing, have 
WinScope do its thing just in case I need its information. 
That's come in handy several times, such as when I get a 
GP Fault. The standard so-called post-mortem debuggers, 
like Borland's WinSpector or Microsoft's Dr. Watson, are 
certainly handy, and WinScope works alongside these pro¬ 
grams quite nicely by showing the events that led to the 
crash. 

Other Features 

The file dialog that comes up when the Load Applica¬ 
tion menu is selected has an interesting checkbox option 
called Add to Quickload. If you select this option, and then 
click the OK button, WinScope adds your chosen applica¬ 
tion to what it calls a quickload list. 

This quickload list is simply a list of programs you want 
to have easy access to in the future. You can access the 
quickload list from outside the Load Application menu by 
pulling down the File menu and selecting Quick-load Ap¬ 
plication. This brings up a dialog box listing all programs 
that have been added to the quickload list. From here you 
can select any program in the list and run it, much as you 
can with the Load Application dialog; the difference is that 
you don't need to scroll through directory listings to find 
the programs. This feature is handy for programs you 
load often. 

Some other interesting features are: 

• You have the ability to save MDI Child window ar¬ 
rangements. 
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• You can have the trace appear in a secondary mono¬ 
chrome monitor. (This tends to slow things down, but 
it's handy for viewing events as they happen. However, 
the trace tends to scroll rather quickly through the 
monochrome monitor, so it's not always useful.) You 
can also output to another system across a COM port. 

• You can monitor timing with great precision; the trace 
window includes the amount of time an API call took 
to execute, as well as the amount of time that has 
passed since the previous event. The times are listed in 
microseconds. (The timing is even more accurate if you 
run in 386-enhanced mode; this allows WiriScope to 
load a special VXD for monitoring timing.) 

• The Trace window has a buffer that's limited to 32,767 
bytes; you can have larger traces by choosing an op¬ 
tion to page to disk. You can also view tracing as it 
occurs by disabling a Minimize on Start option, thereby 
leaving the WinScope window visible during tracing. 
One very powerful set of features consists of the re¬ 
verse-engineering capabilities. Used in conjunction with 
other programs such as a standard debugger and a disas¬ 
sembler program, these capabilities let you do a pretty 
good job of reverse-engineering someone else's software. 
WinScope can monitor all of the DLL function calls the 
software in question makes, as well as any messages it 
receives. You can also set a breakpoint to occur on certain 
events, then use your regular debugger to step through 
the algorithms that take place in response to these ac¬ 
tions. 


For purposes of reverse-engineering, I find it handy to 
use WinScope initially during a run of a program, and 
then print the trace, so that I can see what DLL calls were 
made in what order. I then have the printout handy and 
can begin tracing through the program the old-fashioned 
way with the help of Turbo Debugger. I use other tools in 
conjunction with Turbo Debugger, such as those that 
came with the book Undocumented Windows (Schulman, 
Maxey, and Pietrek: Addison-Wesley, 1992) and one I 
wrote which reads the name of a specified library and 
function (such as USER and GetUindowO) and displays a 
message box listing the address of the function in selec- 
tor:offset form. All this combines into some pretty power¬ 
ful reverse-engineering capabilities. 

Scripting 

This is one area that makes WinScope incredibly versa¬ 
tile. You can log calls to functions inside custom DLLs as 
well as custom messages. You do this by writing script 
files, and compiling them to a native form using a script 
compiler, included with the package. 

To create a script for logging custom messages, you 
specify the window class the message goes with. You 
need to specify this window class, since the messages are 
typically unique to each class, and are usually offsets from 
HMJJSER. (For instance, in windows.h, both the listbox mes¬ 
sage LB_GETTEXT and the edit control message EM_GETLINE- 
COUNT are simply defined as UM_USER+10 ; the way each con¬ 
trol handles the message is uniquely coded in the control 
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class's window procedure.) You can also define the pa¬ 
rameters for these messages using syntax very similar to 
enums in C. 

Creating a script for loggng functions in custom DLLs isn't 
too difficult. WinScope ships with a program called the Script 
Extractor which can scan a DLL for exported functions and 
create a script for these functions. You then add to the result¬ 
ing file the information for the function parameters. 
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After creating the scripts, you compile them using the 
script compiler, which creates files of the extension .use. 
(The scripts have extension . scr, which happens to be the 
same extension used for windows screen savers.) 

Once the .use files are made, you make sure they're in 
the same directory as the WinScope program. Then, when 
you restart WinScope, it will scan through all the .w'sc files 
in its directory, and add all the custom messages and 
functions to its Message and API win¬ 
dows. You are then free to choose 
these for event logging. 

The scripting language is rather 
sophisticated; in fact, the manual lists 
the entire grammar for the language 
in formal BNF. 
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Figure 2 WinScope’s MDI window interface 


Documentation and Support 

The manual is well-organized; it 
begins with the installation proce¬ 
dure, complete with screen captures, 
and a rather short 10-page tutorial. 
The tutorial takes only a few minutes 
to go through, and that was enough 
to get me rolling with the product. 
Then, as I needed to learn more, I sim¬ 
ply looked up topics as I needed them. 

There's a chapter on overall fea¬ 
tures, as well as a chapter on general 
use of the product. There's a com¬ 
plete reference guide that explains 
the windows and menus in detail. 
There's also a chapter on the script¬ 
ing language. Appendix A is a short 
article (eight pages) explaining in 
rather simple terms how the Win¬ 
dows message system works. Appen¬ 
dix B lists different error messages 
that result from WinScope or any of 
the accompanying programs; Setup, 
the Script Extractor, and the Script 
Compiler. The final appendix explains 
the entries in WinScope's initializa¬ 
tion file, winscope.ini. A rather thor¬ 
ough index follows. 

The online help system is pretty 
impressive. It includes context-sensi¬ 
tive help, available at any time 
through the FI key. It also has a 
rather unique feature: you can use 
the WinScope . ini file to specify the 
location of the SDK help for the Win¬ 
dows API. Then, when you're in any 
of the API List, Message List, Flook 
List, Trace, or Parameter windows, 
you can select an item and dou¬ 
ble-click the right mouse button; 
the WinFlelp will appear with the 
Windows API help loaded and your 
requested topic in view. 
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C CODE FOR THE PC 

source code, of course 

Graphic 7.0 (high-resolution, scientific plots in color & hardcopy, contour plots, device independence).$370 

TE Editor Developer’s Kit for Windows V 4.0 (full screen editor, undo command, word processing; TER for application build-in; no royalties) $300 
ZIP Image Processor & Victor Image Library Version 2.2 (brightness, contrast, merge images, TIFF/GIF/PCX/bin, HP ScanJet support) . . $290 
C/C+ + Libraries by Code Farms (persistent C structures, ER models, dynamic arrays, database functions, Jolt Award winner; specify C or C+ + 1S250 

TUrboTcX (Release 3.1; HP, PS, dot drivers; CM fonts; LaTgX; MetaFont).$250 

Crusher! VZOO (platform-independent data compression for network transfer; beats PK & LH on binary; directory trees; portable C) .... $215 

TE Editor Developer’s Kit Ver. 3.0 (full screen editor, undo command, multiple windows; with Word Processing $280).$190 

COMM-DRV (complete interrupt-driven serial communication libraries & device drivers; full source). $155 

Minix Operating System (Version 1.5; Unix-like operating system, includes manual; specify 5.25” or 3.5” diskettes).$150 

XASM (cross assemblers & utility programs; 65xx, 68xx, 80xx; Intel or Motorola hex format; macro preprocessor) .$150 

Delorie GCC for MS-DOS (Version ZZ2; includes C++, assembler, DOS extender, 387 emulation; complete source code and makefiles) . . $150 
Updated! Moby Crypto (PGP, DES, Secure Hash, UFC, MDs, Crack 4.1, Lucifer, IDEA, VCR+, large integer packs, tutorials, more; not for export) . . $150 

Lisp for DOS (Kyoto Common Lisp and CLISP; KCL includes Lisp-to-C translator for building mixed Lisp/C programs) .$140 

Ibrow (Version 4.1; programmer’s Windows-based editor, large files, help, undo/redo, drag-n-drop, function & type tags).$135 

Updated! SCM (portable Scheme in C, IEEE standard, includes JACAL symbolic math package; SCM-4D0/SLIB-1D5/JACAL-1A3) .$100 

PC/IP (CMU/MIT TCP/IP for PCs; Ctynwr drivers, NFS server, Bdale mailer, PCRoute/PCBridge, NDIS/ODI drivers, Beholder, more) . . . $100 

DA (disassembler for Microsoft's New Executable (NE) binary files including Windows .exe, .drv, .dll, and .fit).$95 

Script Interpreter (a command script interpreter for DOS-based systems; C-fike script language; lots of features).$90 

CELP 3.2c (Federal Standard 1016 Code Excited Linear Predictive voice sampling and encoding; voice over 4.8kbps; Unix code).$80 

CPPCOMM (C+ + serial communications class library for DOS, Windows, OS/2, and NT; includes X/Y/Zmodem).$75 

ET Neural Net (back error propagation and Kohonen). $75 

Kier DateLib (all kinds of date manipulation; translation, validation, formatting, & arithmetic).$60 

Coder’s Prolog (Version 3.0; inference engine for use with C programs).$60 

Updated! PCCTS Version 1.10 (Purdue Compiler Construction Idol Set; like YACC and LEX together with lots of additional features).$60 

FlexList (doubly-linked lists of arbitrary data with multiple access methods; specify C or C++).$50 

Container Lite V 1.82 (C+ + & FLC wrapper emulators; portable, persistent containers of arbitrary data including pointers).$50 

BigFloat (arbitrary precision floating point arithmetic ana functions; includes BCD conversion).$50 

EZCalc (ASCII algebraic expression evaluator, unlimited parenthesis nesting, symbols, 32 built-in functions, easily extended).$50 

Backup & Restore Utility by Blake McBride (multiple volumes, file compression & encryption).$50 

CLIPS Version 6.0 (rule-based expert system generator; Windows compatible; manuals on disk).$50 

SuperGrep (exceptionally fast, revolutionary text searching algorithm; also searches sub-directories).$50 

OBJASM (convert .obj files to .asm files; output is MASM compatible) .$50 

Editor Pack (20 public domain editors; micromacs 3.12, Stevie, Elvis, Moke, mg2a, DTE, Jove, Origami, CE & GRIEF}.$50 

Exceptions for C (Ada-like exception handling for C programs; exceptions for any block; exceptions can be reraised).$45 

DES Encryption & Decryption (2500 bits/second on 4.77 MHz PC for on-the-fiy encryption at 2400 baud; not for export).$40 

Database Pack (9 databases-simple to complex: isam, bplus, AVL, SDB, ID, gdbm, Requiem, Ingres89, Postgres).$35 

COP (poor man’s C++; C macro package which implements C++in C) . $35 

OCT (Object C Translator; essentially Brad Cox’s Objective-C Version 4) . $35 

RXC & EGREP Version 2.0 (Regular Expression Compiler and Pattern Matching; finite state machine from regular expression).$35 

Bison & BYACC (YACC workalike parser generators; documentation; includes (Jand C+ + grammars) .$35 

Spell Pack (6 spelling programs, a hyphenator, 2 utility packs and a 60K word list: Ispell, Microsp, Sp, Cspella, Spell, Dawg, Soundex) .... $30 

REGX Plus (Version 3.0, search and replace string manipulation routines based on compiled regular expressions).$30 

GNU Awk & Diff for PC (both programs in one package).$30 

Big Number Pack (7 arbitrary precision arithmetic packages in C, one in Fortran but free Fortran-to-C converter is included) .$30 

Crunch Pack (30 file compression & expansion programs; now includes portable ZIP).$30 

NEW! OORT (C++ray tracing code from the book by Nicholas Wit) .$30 

OEmacs (full GNU Emacs for DOS and Windows DOS box; C++ support, etags++, lots of .el files) .$25 

NEW! CTask Version 2.22d (robust MS-DOS multitasking kernel; C functions run as light-weight processes; mailboxes, interrupts, pipes, etc.) . . . $25 

PERL for MS-DOS (Version 4.019; C, sed, awk, and shell all rolled into one language; includes hardcopy docs).$25 

Updated! FLEX Version 2.4.3 (fast lexical analyzer generator; new, improved LEX).$25 

GNU RCS (FSFs version of the Revision Control System; like Unix’s SCCS only better; keeps track of software development).$20 

Data 

Moby Thesaurus II (6,000 root words, 2.5M synonyms, "common sense”, concept related searches) .$500 

Moby Pronunciator II (175,000 words & phrases encoded with full IPA pronunciation & emphasis points).$265 

Moby Part-of-Speech II (230,000 words and phrases described by prioritized part(s)-of-speech).$170 

Moby Hyphenator II (185,000 words fully hyphenated/syllabified).$105 

Moby Words II (610,000 words & phrases with Scrabble(tm) word list, place names, baby names, acronyms, core list for spell checkers) . . . $100 

CIA World Bank II Database (13MB of maps, 5.7M vectors; coastlines, rivers, political boundaries; 5.25” HD only).$35 

U. S. Cities (names & longitude/latitude of 32,000 U.S. cities and 6,000 state boundary points).$35 

The World Digitized (100,000 longitude/latitude of world country boundaries) .$30 

CD-ROMs 

BSD/386 (POSIX-compatible O/S; complete development package, full networking, kernel debugger, X11R5, DOS box; complete source code) $900 

NEW! AI CD-ROM (expert systems, neural networks, genetic algorithms, fuzzy logic, linguistics/naturafTanguage).$105 

NEW! OmniMap (street-level US mapping; lots of topographical features, Windows viewer, output to many file formats).$75 

FontMaster II CD Library (soft fonts for HP and HP compatible laser printers, 36 different type faces; 5,200 bit mapped fonts; 300MB) . . . $70 

Updated! Prime Time for Unix (Volume 3, No. 1, Januare, 1994; over 6GB of Unix C code).$60 

Walnut Creek Libris Britannia (over 600MB of the best of British boards; not all source included).$50 

Linux/GNU/X by Yggdrasil Computing (run from the CD; TCP/IP & NFS; drivers; MPEG; SCSI support; lots more).$45 

Walnut Creek C User’s Group (Volumes 100 to 364).$40 

InfoMagic Unix (three public domain Unix systems: 386BSD, FreeBSD, and NetBSD).$40 

NEW! Mailer’s Lookup (9-digit ZIP codes by street address, distances between ZIP codes, phone locations; on-line tool, no source code).$35 

Knowledge Media Multimedia (625MB & 13,000 files; 1,232 sounds, 179 books, 100 movies, 114 stacks, 606 programs, 214 mods) .$35 

Project Gutenberg (literature, historical documents, reference books, census data, religious documents, math constants, etc.) .$35 

Knowledge Media Languages & Operating Systems (640MB of compilers, libraries, and operating systems; source code & executables) . . . $35 

Walnut Creek XJ1R5 and GNU (X11R5 with contributed and comp.sourcesjt, over 120 GNU programs, complete C source).$35 

Walnut Creek Usenet and Simtel Unix-C (600MB).$35 

Walnut Creek Giga Games (arcade, simulations, card games, education, trivai, cheat sheets; some source).$35 

Austin Code Worics Internet Warrior #1 (PC Internet tools: Gopher, Wais, Eudora, ph, Nupop, Thimpet, TCP/IP, FAQs, drivers, docs) . . . $35 

NEW! Walnut Creek FreeBSD (Berkeley 32-bit operating system for PCs; bootable).$35 

W&lnut Creek Tbolkit for Linux (Slackware distrubtion and complete Linux archive). $35 

Knowledge Media MegaMedia I and II (images, sounds, movies).each $30 

Walnut Creek CICA Windows Archive (August 1993) .$20 

Walnut Creek Simtel 20 MSDOS Archive (C source code but lots of other stuff too).$20 

The Austin Code Works much more ... ask for catalog Voice: (512) 258-0785 

11100 Leafwood Lane FAX: (512) 258-13)2 

Austin, Texas 78750-3587 USA http://www.clark.net/acw/home.html E-mail: info@acw.com 

Free surface shipping for cash in advance For delivery in Texas add 7% MasterCard/VISA/AMEX 
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Between the manual and the online help, I found no 
need for technical support; however, Periscope does have 
a technical support line (not an 800 number), available 
Monday through Friday (excluding holidays) between 1 pm 
and 5pm Eastern Time. They also have an online BBS for 
registered users and a CompuServe forum (see Product In¬ 
formation box). 


Future Improvements 

The program isn't perfect; one thing I found missing, 
which perhaps Periscope might consider for future re¬ 
leases, is a "dumper.' When the program logs an API call, 
such as a file I/O operation, that takes a handle into 
global memory or a long pointer into some sort of buffer, 
the trace gives you only the handle or the pointer to the 
buffer. It would be handy if WinScope could optionally 
dump the contents of the buffer. Currently, it will do so if 
this buffer is a string and the parameter in the API call is a 
LPSTR, but it won't, do it for other 
blocks of data. It would be nice if in 
the scripting language you could tell 
it to dump blocks of data and specify 
the size of the blocks to dump (or 
even specify how to calculate how 
much to dump). This would be par¬ 
ticularly useful, since after the pro¬ 
gram is finished executing, these 
data blocks are probably long-gone, 
and a pointer to the data is pretty 
much useless. 

New Features 

As this article goes to press, Peri¬ 
scope is releasing a new version of 
WinScope (vl .2). The new version in¬ 
cludes scripts that allow WinScope to 
automatically monitor more APIs, 
specifically the OLE v2.0 API and the 
Telephony API (TAPI). Support for de¬ 
vice-driver API functions (and other 
functions called via GetProcAddrO ) is 
also included and can be useful for 
debug execution of printer, monitor, 
and other device drivers. The new 
version also features the ability to re¬ 
cover a trace file after a crash, which 
is intended to ensure that the Win¬ 
Scope trace buffer will contain the 
latest events preceding the crash, 
making it easier for you to determine 
what led to the crash. Other new fea¬ 
tures include tracing of interrupts and 
faults, and the ability to use multiple 
project directories. 

Conclusion 

WinScope is easy to use and ex¬ 
tremely powerful: it's by far one of 
the handiest tools I've used. I think 
every developer should have a copy, 
especially those who do a lot of re¬ 
verse-engineering. I use lots of dif¬ 
ferent programs for reverse-engi¬ 
neering and debugging, and have 
found WinScope to be one of the 
most helpful. □ 
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-lint 


for C/C++ 

presents Bug # 521 



The programmer got more than the 5 'abc’s expected. What went wrong? 
Call if you need a hint. Refer to Bug #521. 


PC-lint for C/C++ will catch this and many 
other bugs. It will analyze a mixed suite of C 
and C++ modules to uncover bugs, glitches, 
quirks and inconsistencies. 

Numerous C++Warnings and Messages: 
Are your inherited destructors virtual? Are 
your constructor new's matched by your 
destructor delete’s? Are your initializers 
in order? Are names inadvertently hiding 
other names? Are your C++ modules 
consistent with your C modules? Much, 
much, more. 

Plus Our Traditional C Warnings: 

Uninitialized variables, unaccessed variables, 
possibly uninitialized variables, strong type 
mismatches, indentation irregularities, loss of 
precision, strange uses of Booleans, 
signed/unsigned mismatches, suspicious 
expressions, unused macros, etc. etc. 


Full C++ Support - PC-lint for C/C++ 
is based on the ARM and is tracking the 
latest ANSI/ISO draft including exceptions 
and templates. It supports both Borland and 
Microsoft C/C++. 

Options Galore: A plethora of options for 
message suppression, message format, 
compiler dependencies, etc. All messages 
can be individually suppressed or enabled, 
both locally and globally. Numerous 
compilers/ libraries supported. Runs on 
MS-DOS (Optional built-in 386 DOS 
extender) and OS/2. 

PC-lint for C $139 
PC-lint for C 1C++ $239 

PC-lint users: call for update pricing 
Unix and Mainframe programmers: 

call for pricing for FlexeLint. 




3207 Hogarth Lane, Collegeville, PA 19426 

CALL TODAY (610) 584-4261 Or FAX (610) 584-4266 

30 Day Money-back Guarantee. 


PA add 6% sales tax. 


PC-lint and FlexeLint are trademarks of Gimpel Software 
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Edited by 
Leor Zolman 


Please send us your best 
tricks and hacks —those 
clever pieces of code to 
make things work the 
wag they should! You’ll 
receive at least $50 for 
each tip that we print 
Send your submissions to.- 
Tech Tips 
Leor Zolman 
74 Marblehead Street 
North Reading, MA 01864 
leor@bdsoft.com. 


More Application Launching, 

A Windows/UNIX 
Cohabitation Bug, and 
Quick Printer Configuration 

Launching DOS Applications from Windows Programs 


Juan M. Aguirregabiria 
wtpagagj@lg.ehu.es 



From Windows one can start a DOS program by using the File/Execute 
menu of Program Manager or from any other program that uses the API func¬ 
tion UinExecO. In either case, if the resulting DOS box is minimized, the same 
icon is always used. If, on the contrary, you first install the application in the 
Program Manager, you can define, among other properties, the icon, starting 
directory, and window caption to be used by the DOS box. 

When I wrote a Windows shell replacement (a public domain program 
called Toolbar) a year ago, I wanted to provide the same possibilities. I was 
unable to find any mention of this point in the written documentation that 
came with my compiler (Borland C++ 3.1). Finally, I found in the help file a 
topic called 'Shell Dynamic Data Exchange Interface,' which includes at the end 
a short description of how you can associate an icon, a starting directory, and 
a caption with a DOS program. Unfortunately, there was no information on the 
icon that must be provided by the program, I had to guess the actual meaning 
of an icon handle and the structure of the object it represents. (When I finally 
received my copy of Undocumented Windows, by Schulman, Maxey, and Pietrek, 
I could confirm that my guess was right.) 


Leor Zolman is a consultant specializing in C programming training, an instructor on 
UNIX topics for Boston University's Center for Information Technology, and"Tech Tips" 
editor for Windows/DOS Developer's Journal. His book, Illustrated C, was publish¬ 
ed in 1992. He may be contacted at 74 Marblehead St, North Reading, MA 01864. 
Internet address: leor@bdsoft.com. 
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» BGI & Microsoft graphics interface 
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$290, No Royalties 
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• Support for NVatcom ('9.5/386 

• Support for Borland C++ for OS-2 

$250, No Royalties 
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\ 
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• Source level debugger for C ++ , C and 
assembler programs. 

• Easy to use expansion of classes, 
structures, pointers, arrays, etc. 

• Powerful run-time memory protection 
detects pointer bugs 

• Full nested call traceback display with 
automatics and parameters 

• Unlimited number of break and trace points 

• History buffer for recording up to 
32,000 source lines and variables 

•ding for 




FlashTek is proud to offer former Zortech 
products, by the original authors, now with 
support for other compilers. New features, 
fantastic support, no royalties, and great 
prices. - 

ORDERS 800-397-7310 


FlashTek, Inc. 

121 Sweet Ave. 

Moscow, Idaho 83843 
Info: 208-882-6893 

Email: flash@proto.com 

FAX: 208-882-7275 


FlashTek, Ltd. j 
3 Partnership House 
William Brook Park 
Grantham, Lines j 
England NG3I 9HZ 


FAX: 208-882-7275 Voice+44-476-74108 

FAX+44-476-61382 

Borland, BGI, Watcom and Zortech are trademarks of 
their respective companies. 
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After several tries (the help file 
had several misprints), I developed a 
function, UinRunO, that can be used 
instead of the UinExecO API function 
to start Windows and DOS applica¬ 
tions from any Windows program. 

Recently, I was able to help a 
friend use this capability in a pro¬ 


gram that needed to start a DOS ap¬ 
plication. I think it might also be use¬ 
ful to other programmers, even if 
they are not writing shell replace¬ 
ments or program launchers. 

The function declaration is in¬ 
cluded in winrun.h as follows: 


Listing 1 winrun.c 


j ***★★★**★★*★★★★★****★★*★★★**★*★**★*****★★★★★**★★★★★★★★★**★★**★**★★*★★ 

WINRUN 1.00 


Running (Windows and) MS-DOS programs from Windows 
(0 Juan M. Aguirregabiria 1993 
First version 1-05-93 
Last revision 12-12-93 

**********************************************************************/ 


//include <windows.h> 

//pragma warn -bbf 
#include <dde.h> 

//pragma warn +bbf 
//include "dir.h" 

//include "winrun.h" 

/* .[ Types ]..*/ 


typedef struct tagICONPROPS 
{ 

unsigned unused:12, 
fResponse:l. 
fRelease:l. 
reserved:l, 
fAckReq:1; 
short cfFormat; 
int nWidth, 

nHeight; 

BYTE nPlanes, 

nBitsPixel; 

WORD wAnd, 


wZerol, 

wXor, 

/* Selector = 0 */ 

wZer02; 

BYTE nValuetl]; 

} ICONPROPS; 

/* Selector = 0 */ 

typedef struct { 

WORD nUnkl. nUnk2; 

/* 0010h 0010h */ 

int nWidth, nHeight; 

/* Probably */ 

WORD nUnk3; 

/* 0004h */ 


BYTE bBitsPixel. bPlanes; 

} ICONHEAD; 

//define ICONHEADLENGTH sizeof(ICONHEAD) 

typedef struct { 

LPCSTR IpszCmdLine, 

1pszName; 

LPCSTR IpszDir; 

HICON hlcon; 

UINT fuCmdShow; 

} PROGINFO; 

typedef PROGINFO FAR * LPPROG; 
typedef HGLOBAL HPROG; 

/* .[ Variables ].. */ 

static char szDesct] = "GetDescription", 

szDir[] = "GetWorkingDIR”, 

szIcon[] = "Getlcon", 

szServerClassf] = "WinRun_server"; 
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UINT WinRun(LPCSTR IpszCmdLine.UINT 

fuCmdShow.HINSTANCE hlnst, 
LPCSTR IpszName.LPCSTR 
1pszDir,HICON hlcon); 

The first two parameters are exactly 
the same as those for the UinExecO 
function. The third, hlnst, is the in¬ 
stance of the program calling the 
function. The remaining three pa¬ 
rameters are: 

IpszName, which points to the string to 
be displayed in the caption of the 
DOS box (or under its icon). If it is 
NULL, the caption will be the de¬ 
fault one: the text defined in the 
corresponding PIF file or the name 
of the program. 

1 pszDir, which points to the string 
containing the starting directory. If 
it is NULL, the default is the direc¬ 
tory in the PIF file or the current 
working directory. 

hlcon, which is the handle of the icon 
to be used when the DOS box is 
minimized. If it is NULL, the stand¬ 
ard MS-DOS icon will be used. 
Note that, since the icon should 
be shared through a DDE talk, it 


Listing 1 continued 


static BOOL fStarting; 

/*.-.[ Utilities ]---*/ 

void PostStringtHWND hwndServer.HWND hwndClient,LPCSTR 1pszString,ATOM altem) 

{ 

GLOBALHANDLE hDdeData; 

DDEDATA FAR *lpDdeData; 

hDdeData = G1 obalAIlocCGHND I GMEM_DDESHARE, 

sizeof(DDEDATAJ+lstrlen(1pszStri ng)); 

if (hDdeData) { 

IpDdeData = (DDEDATA FAR *)GlobalLock(hDdeData); 
if (IpDdeData) { 

1pDdeData->fResponse = 1; 

1pDdeData->fRelease = TRUE; 

1pDdeData->fAckReq = FALSE; 
lpDdeData->cfFormat = 0; 

. 1strcpyf{LPSTR)1pDdeData->Value,l pszString); 

G1obalUniock(hDdeData); 

if (PostMessagethwndClient,WM_DDE_DATA,(WPARAM)hwndServer; 

MAKELPARAM((WORD)hDdeData.(WORD)altem))) return; 

} 

GlobalFree(hDdeData); 

} 

Global DeleteAtom(altem); 

} 

void PostlconfHWND hwndServer.HWND hwndClient,HICON hlcon.ATOM altem) 

{ 

GLOBALHANDLE hlconProps; 

ICONPROPS FAR *1plconProps; 

BYTE FAR *lp!conHead; 


★ 

★ 


Windows Sockets, 
RPC/XDR, 
Telnet, FTP... 


O 

*P 
A 
5 * 

for Windows 


Windows Sockets, Berkeley Sockets 
Kernel, RPC/XDR, FTP and Telnet 
toolkits ... all in one 
100% DLL (uses only 4K DOS memory) 
Uses less memory than any other DLL or 
TSR implementation even when loaded 
Up to 128 concurrent sockets 
Coexists with Novell, Banyan or LAN 
Manager at no additional cost 

Supports NDIS, ODI and Packet drivers; 
SLIP and PPP with scripting 
TCP Tools: FTP (drag and drop), TFTP, 
Telnet, LPR/LPD, Back-Up with TAR 


fastfacts: 408.867.4742 
fax: 408.741.0795 

email: mktg@distinct.com 


dfstmct 

408 . 741.0781 
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RS232-Toolkit, SuperCom 3.0 
for DOS, Windows, I^T, OS/2 

for MS C/C++, Visual C++, Turbo /^fannd C/C++, 

s IpeS&M Mp<M M£§g png^dnal^om^&m- 

cation software. That means high data^ajfrity and highest trans¬ 
mission speed. The SuperCom librwie^ire fast even in a multi¬ 
tasking operating system like^V4®h^vs, Windows NT or OS/2. 
The same programming inteS^Ws used among different 
languages and operating systsWs. 

• Interrupt driven: transmission, receptiofc^status, • Language independent DLL (Windows, NT, OS/2) 

modem status. Up to 115,200 bps. which can be used for simultaneous transfers by 

• UARTS: 8250,16450,16550 FIF0P|p^8rt address, applications. 

• Simultaneous COM_1 ..COt^Btrefloiinlimitedl. • Multiserial board support (AST, ARNET, DigiBoard 

• Direct register programrgj«£Jggmpt-Sharing, PC/X, STARGATE). Reduces loading of CPU 
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• Protocols: ASCII, XMODEM, XMODEM/CRC, • Modem support. 

YMODEM, YMODEM/BATCH, ZMODEM. • No resident drivers*. Just link the LIB. 

• Timer, Ctrl-Break and Exception handling. • No Royalties. 

• Multitasking support (Windows, NT, OS/2) •FREE technical support. FREE demo 

• Protected Mode Interface, 386-Technology. • Full source code (C or Pascal and optimized ASM). 

• User Event Routines under DOS and Windows. • SuperCom++ (C++ or Pascal OOP) included. 

Under Windows user can even post messages to • Protected Mode Interface (Windows) included, 
the application using PostMessage. 

C/C++ or Pascal package for DOS only $299 
C/C++ or Pascal package for Windows, OS/2 or NT each $399 
C/C++ or Pascal combo pack for DOS+Windows only $528 
C/C++ or Pascal combo pack for Windows+NT only $598 
C/C++ combo pack for DOS+Windows+OS/2 only $799 
C/C++ combo pack for DOS+Windows+NT only $799 
C/C++ combo pack for DOS+Windows+OS/2+NT only $999 

•under DOS and Windows 3 x _ VISA. MC. COD. Check accepted. 
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better 
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now with... 



*U> Covers UNIX .wd DOS Platforms 
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Author of BDS C 


Discover the WHY and 
HOW of application design 
and development in C. 
Explore the construction of 
several different applications 
from start to finish. Chapter 
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your skills through in-depth 
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CALL TODAY! 
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Listing 1 continued 


int i, 1, d: 


} 


1pIconHead = (BYTE FAR*)GlobalLock(hlcon); 
d = (GetSystemMetrics(SM_CXICON)*GetSystemMetrics(SM_CYICON))/8; 
i = ((ICONHEAD FAR*)1pIconHead)->bBitsPixel; 

1 = d*(i+l)*(( ICONHEAD FAR*)1pIconHead)->bPlanes; /* ??? */ 
hlconProps = GlobalAlloctGHND I GHEM_DDESHARE,sizeof(ICONPROPS)+l-1); 
if (hlconProps) { 

lpIconProps = (ICONPROPS FAR *)GlobalLock(hIconProps); 
if (lpIconProps) { 

1; 

TRUE; 

FALSE; 


IpIconProps-SfResponse 

1pIconProps->fRel ease 

lpIconProps->fAckReq 

lpIconProps->cfFormat 

lpIconProps-SnWidth 

IplconProps->nHeight 

lpIconProps->wAnd 

lpIconProps->wXor 

lpIconProps-SnPlanes 

lpIconProps-SnBitsPixel 


if (1 > (i 
1 


GetSystemMetrics(SM_CXIC0N); 
GetSystemMetrics(SM_CYICON); 

FIELDOFFSET(ICONPROPS,nVa1ue); 

1plconProps->wAnd+d; 

((ICONHEAD FAR*)1pIconHead)->bPlanes; 
((ICONHEAD FAR*)1pIconHead)->bBitsPixel; 


(int)GlobalSize(hlcon)-ICONHEADLENGTH)) 


hmemcpy((void _huge *)lpIconProps->nValue, 

(const void .huge *)(1pIconHead+ICONHEADLENGTH),1); 
GlobalUnlock(hlconProps); 

if (PostMessage(hwndClient,WM_DDE_DATA,(WPARAM)hwndServer, 
MAKELONG(hlconProps.altem))) { 
GlobalUnlock(hlcon); 
return; 


} 

) 

GlobalFree(hlconProps); 

} 

GlobalUnlock(hlcon); 

G1obalDeleteAtom(altem); 


/* --[ Server procedure ]. */ 

LPARAM CALLBACK ServerProctHWND hwnd.UINT msg,WPARAM wParam.LPARAM 1Param) 

{ 

switch (msg) { 


case WMJDEJNITIATE: 
if (fStarting) { 
ATOM aApp, aTop; 
HPROG hProg; 
LPPROG IpProg; 
int nCmdShow; 


hProg = (HPROG)GetWindowWord(hwnd.0); 

IpProg = G1obalLock(hProg); 
nCmdShow = lpProg-SfuCmdShow; 

GlobalUnlock(hProg); 

if (nCmdShow == SW_SH0WMINNOACTIVE) nCmdShow |= SW_MINIMIZE: 
aApp = G1obalAddAtom("Shell"); 
aTop = G1obalAddAtom("AppProperties"); 
if (IParam == MAKELPARAM(aApp,aTop)) { 
SetWindowWord(hwnd,2,wParam); 
SendMessage((HWND)wParam,WMJDE_ACK, 

(WPARAM)hwnd.MAKELPARAM(aApp.aTop)); 

} 

else { 

G1obalDeleteAtomtaApp); 

GlobalDeleteAtom(aTop); 

} 

} 

return 0; 


case WM_DDE_REQUEST: 

{ 

char szltem[15]; 
HPROG hProg; 
LPPROG IpProg; 
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cannot be a handle obtained with 
the LoadIcon() function. You can 
safely use ExtractlconO to get the 
handle of an icon in any EXE, DLL, 
or ICO file. 

The complete code for the Uin- 
Run() function is included in uinrun.c 
(Listing 1). 

A minimal program launcher ap¬ 
plication (launcher, h, launcher, c, 
launcher.rc, launcher.def, and launch- 
er.mak, in Listings 2-6, respectively) is 
also included to show the use of the 
function. One could easily improve 
this sample application adding, for in¬ 
stance, the following possibilities: 

- Specifying (in the fuCmdShorf) if the 
application should start minimized 
(or hidden). 

- Including a Browse button to 
search for the program and icon 
files. 

- Allowing selection of any icon in a 
file. LAUNCHER always uses the 
first one. 


Listing 1 continued 


hProg = (HPROG)GetWindowWord(hwnd,0); 

IpProg = GlobalLock(hProg); 

GlobalGetAtomNamei(AT0M)HIW0RD( 1 Param),szltem,sizeof(szltem)); 
if (IpProg-MpszName && ! 1 strcmpi(szltem,szDesc)) 

PostString(hwnd,(HWND)wParam,1pProg->lpszName,(ATOM)HIW0RD(1Param)) 
else if (lpProg->lpszDir M !lstrcmpi(szIteni,szDir )) 

PostString(hwnd,(HWND)wParam,1pProg->lpszDir ,(ATOM)HIWORD(lParam)) 
else if (1pProg->hIcon M !1strcmpi(szltem,szlcon)) 

Posticon (hwnd,(HWND)wParam,lpProg->hIcon ,(ATOM)HIWORD(lParam)) 
else if (!PostMessage((HWND)wParam,WM_DDE_ACK, 

(WPARAM)hwnd,MAKELPARAM(0.HIW0RD(1Param)))) 

Global DeleteAtom(HIWORD(lParam)); 

GlobalUnlock(hProg); 

} 

return 0; 

case WM_DDE_TERMINATE: 
case WM_CL0$E: 

G1obalFree((HPROG)GetWindowWord(hwnd,0)); 
if (GetWindowWord(hwnd,2)) 

PostMessage((HWNDIGetWindowWordt hwnd,2),WM_DDE_TERMINATE, 

(WPARAM)hwnd,0L); 

DestroyWindow(hwnd); 
return 0; 

} 

return DefWindowProc(hwnd,msg,wParam,lParam); 

} 

/* .[ Main proc ]--*/ 

UINT WinRuntLPCSTR 1pszCmdLine,UINT fuCmdShow,HINSTANCE hlnst. 
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Feature Comparison 
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Tool palette provides easy access to a 
complete set of visual authoring tools 

YES 
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NO 

Automatically converts Word documents to 
Windows help files 
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Automatically converts help files to 
printed documents 
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Topic Wizard automatically creates and 
formats any number of help topics 
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NO 

NO 

Built-in support for adding animation 
and slide shows to help files 
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NO 

List Price 
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accurate display of 24-bit images 

• Support for EGA/VGA/SVGA, 32K- 
and 16 million-color displays 

• Scan b/w, grayscale, and color 
images with ScanJet scanners 

Print halftones, diffusion scatters, 
and color pictures 

Convert images between 1-, 8-, 
and 24-bit formats 



► 

► 

^ Convert color to grayscale 

► 


Includes a complete image 
processing application with C 
source 


fCc 


Your Windows application can load and 
save BMP, TIFF, PCX, GIF. TGA, and JPEG 
files, control scanner and printer, and have 
powerful Image processing and color 
reduction for the very best Image display. 

Victor Image Processing Library 
for Windows (DLL), $295 

Victor Image Processing Library 
for DOS, supports Microsoft 
and Borland C/C++ compilers, $195 

Call or fax to order 
314 - 962-7833 


Catenary Systems 

470 Belleview St Louis MO 63119 

voice/fax 314-962-7833 

Victor Image Processing Library for Windows or for DOS, No royalties. 5ource code available, visa/mc/cod. 
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(Or see the Instantlnfo 
index page elsewhere 
in this issue.) 


You can have 
valuable 
product data in 
mcS© - just 
punch in the 
document # you 
want, your FAX 
number, and 
your name. 

It’s that easy! 


FAST 


Windows/POS 

□ DEVELOPER'S JOURNAL 

Instantlnfo 

Response 

Service 


EASY 


Listing 1 continued 


LPCSTR 1pszName,LPCSTR 1pszDir,HICON hlcon) 

{ 

BOOL bRes; 
static BOOL fClass; 

HWND hwnd; 

if UlpszName && llpszDir && !hlcon) 
return WinExeci1pszCmdLine.fuCmdShow); 

if (IfClass) { 

WNDCLASS wndclass; 

wndclass.style 
wndclass.IpfnWndProc 
wndclass.cbClsExtra 
wndclass.cbWndExtra 
wndclass.hlnstance 
wndclass.hlcon 
wndclass.hCursor 
wndclass.hbrBackground 
wndclass.IpszMenuName 
wndclass.1pszClassName 

RegisterClass(&wndclass); 
fClass = TRUE; 

} 

hwnd = CreateWindowiszServerClass.NULL,0,-100.-100.0.0,NULL.NULL.hlnst,NULL); 
if (hwnd) { 

HPROG hProg; 

LPPROG IpProg; 

hProg = GlobalAlloc(GHND.sizeof(PROGINFO)); 
if (hProg) { 

IpProg = G1obalLock(hProg); 
lpProg->lpszCmdLine = 1pszCmdLine; 

lpProg->lpszName = 1pszName ; 

1pProg->lpszDir = IpszDir ; 

lpProg->hIcon ■ hlcon ; 

lpProg->fuCmdShow = fuCmdShow ; 

G1obalUnlock(hProg); 

SetWindowWordfhwnd.0,(WORD)hProg); 

SetWindowWord(hwnd,2,0); 

) 

else { 

DestroyWindow(hwnd); 
hwnd = NULL; 

} 

} 

fStarting = TRUE; 

bRes = WinExecOpszCmdLine, fuCmdShow); 
fStarting = FALSE; 

if (hwnd) 

if (!GetWindowWord(hwnd,2)) SendMessage(hwnd,WM_CLOSE,0,0); 
else while (IsWindow(hwnd)) { 

MSG msg; 

while (PeekMessage(&msg.hwnd.0.0,PM_REM0VE)) { 

TranslateMessage(Smsg); /* Probably unnecessary */ 

DispatchMessagel&msg); 

} 

} 

return bRes; 

} 

/* End of File */ 


= 0 ; 

= ServerProc; 

= 0 ; 

= sizeof(HPR0G)+sizeof(HWND); 
= hlnst; 

= NULL; 

= NULL; 

= NULL: 

= NULL; 

= szServerClass; 
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A Tale of Two Operating Systems 


Leor Zolman 


As an instructor of hands-on PC-based technical work¬ 
shops, I like to keep all the software used for my classes 
loaded on my notebook computer, and I prefer to connect 
my notebook to a classroom's projection system directly 
rather than load up the software on yet one more class¬ 
room PC. Some of my classes, such as System Administra¬ 
tion and Shell Programming, are UNIX-specific, while oth¬ 
ers, such as C programming, are designed for the DOS 
environment. Therefore, I keep both UNIX and DOS/Win- 
dows resident on my notebook, and boot whichever one I 
happen to need at the time. 

A year or so ago, around the time I first began experi¬ 
menting with ways to keep multiple operating systems 
resident on a single bootable drive, i began seeing a 
strange error when starting up Windows 3.1 (and later, 
both Windows for Workgroups 3.1 and 3.11): an error 
box announced that "the partitioning scheme" I was using 
precluded the use of a permanent swap file. I wasn't sure 
exactly what Windows meant by the term "partitioning 
scheme"; 1 had a primary DOS partition, an extended DOS 
partition, and a UNIX partition, and the UNIX partition had 
nothing in common with the DOS partitions other than 
sharing the same physical hard disk. Under the circum¬ 
stances, I had no choice but to use a "temporary" swap 
file, which at best reduces system response time, and at 
worst renders the system incompatible with certain soft¬ 
ware packages (for example, a version of OmniPage I 
once used would not run without the presence of a per¬ 
manent swap file). 

For a long time, 1 mistakenly assumed that this error 
had something to do with the way my DOS partition was 
set up. At various times I suspected and tested for various 


Listing 2 

launcher.h 

/*********************************************************************** 


LAUNCHER 1.00 

Running (Windows and) MS-DOS programs from Windows 


(0 Juan M. Aguirregabi ria 1993 


First version 12-12-93 


Last revision 12-12-93 

************************************************************************ j 

#define IDD DIALOG 

1 

♦define IDD PROGRAM 

101 

♦define IDD NAME 

102 

♦define IDD DIR 

103 

♦define IDD ICON 

104 

/* End of File */ 



TCP/IP for Windows 



More Windows applications than any other 
TCP/IP package 

Implemented as 100% Windows DLL (not a TSR) 
Requires only 6KB of base memory 
Installs in 5 minutes 

■ Works concurrently with NetWare, LAN Manager, 
Vines, Windows for Workgroups, etc. 

■ Up to 128 simultaneous sessions 

Applications: 

TELNET (VT100,VT220, TVI),TN3270, TN5250, FTP, TFTP, SMTP 
Mail with MIME, PROFS Mail, News Reader, LPR/LPD, PING, Bind, 
Finger, Whois, Gopher, Phonetag, Scripting, Statistics, Custom, 
SNMP Agent 

Developer Tools: 

Windows Socket API, Berkeley 4.3 Socket API, 

ONC RPC/XDR, WinSNMP API 

Extensible SNMP Agent 

■ Includes MIBII, Workstation,Windows and 
DOS agents 

■ Dynamic registration of multipleagents, managers, 
and proxies 

■ WinSNMP API developers kit available 

■ Compatible with any SNMP manager 

■ Free with Chameleon, and ChameleonAlFS 

NFS Client/Server 

■ Network drives are mounted from within Windows 

■ Network printing in the background 

■ Up to 24 network drives 

■ Requires only 6KB of base memory 

■ Included in ChameleonAWS 

For overnight delivery call: 

NetManage 

(408) 973-7171 


10725 North De Anza Blvd., Cupertino, CA 95014 USA 
Fax (408) 257-6405 
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potential culprits such as Stacker, QEMM, and other miscel¬ 
laneous TSRs (none of which had ever caused any trouble 
in the past, but in this industry nothing's for certain...) 

I use SCO UNIX in addition to DOS/Windows, and SCO 
UNIX (as well as SCO XENIX before it) has always cleanly 
supported an automatic multi-boot facility when loaded 
onto a hard disk that previously contained DOS partitions. 
When SCO UNIX is the active partition, the UNIX boot pro¬ 
gram loads first and prompts the user for an operating 
system name. If the user presses Return, UNIX boots. The 
user may type dos to boot from the DOS partition instead 
(this is implemented by having a short DOS bootstrap pro¬ 
gram named dos in the UNIX filesystem's root directory). 


A Total Forms Processing Tool Kit 





► Hand-Printed • Mark Sense 
OCR • Bar Code Recognition 



Stock Requisition 


Bar Code 
for product number, 
territory code, form ID, etc. 


OCR (Type Print) 
for preprinted job code, 
order number, form ID, etc. 


Mark Sense 
for multiple choice, 
rating, true/false, etc 



To skip the UNIX boot prompt altogether and always 
boot DOS directly, all that's necessary is to use the fdisk 
program (either the DOS version under DOS, or the UNIX 
version under SCO UNIX) to make the DOS partition ac¬ 
tive. With the DOS partition active, the Unix partition is 
just so much unused space on the hard disk - or so it 
should be. 

From the time I received my new notebook, it took 
about an additional two months (and, actually, two differ¬ 
ent notebooks from different vendors...) to get SCO UNIX 
up because of an incompatibility between SCO UNIX and 
the dual-scan color notebook's ROM (kudos to the tech 
support folks at Austin Computer for figuring this one out 
and promptly supplying me with a Flash-ROM 'down¬ 
grade' to the previous ROM version, 
which runs fine with UNIX and seems 
to have no other side effects). During 
this period, I ran DOS/Windows 
glitch-free using a permanent swap 
file. Flowever, after I installed UNIX 
successfully, the next time I tried to 
make a change to the Windows 
swap file settings I received the 
dreaded partitioning scheme mes¬ 
sage. Oddly enough, there was no 
problem at all in continuing to use 
the permanent swap file settings al¬ 
ready in effect from before the Unix 
installation, as long as I didn't go into 


ICR (Hand-Printed) 
for name, address, date, 
time, dollars and cents, 
phone numbers, etc. 


Image Capture 
for signatures, 
pictures, drawings, etc. 


Empower Your Software To Read 

The AutoData SDK II Software Developers Kit provides 
state-of-the-art recognition and imaging tools to 
automate data entry from scanned or faxed forms. 


A\UT0 


SYSTEMS 

A Unit of Electro-Sensors, Inc. 


AutoData Systems 

10365 West 70th Street • Eden Prairie, MN 55344-3446 
Phone: 612/941-8180 • FAX: 612/941-7312 

Toll Free: 800/662-2192 



Searching for 
the Cure. 

Cancer sounds like such a 
grown-up disease, but each year, 
more than 6,000 American 
children will be stricken. The 
doctors and scientists at St. Jude 
Children’s Research Hospital are 
working to wipe childhood cancer 
from the face of the earth. To 
learn more about this life-saving 
work, please call 1-800-877-5833. 

ST. JUDE CHILDREN'S 
RESEARCH HOSPITAL 

Danny Thomas, Founder 
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the 386 chip' icon in the Control Panel, make and then 
keep changes to the Virtual Memory settings. 

I decided at that point to try and find out why Win¬ 
dows chooses to react to the mere presence of UNIX on 
the disk by disabling permanent swap file configuration. I 
called Microsoft. 

Now, I was currently running the WFW 3.11 that had 
come bundled with my first dual-scan notebook (I had 
kept the software, since I had opened the packaging, but 
returned the notebook since they couldn't figure out how 
to get SCO UNIX to boot on it), and I cooperatively sup¬ 
plied the Microsoft receptionist with that serial number. 
Surprise! Microsoft doesn't support end users of OEM-dis¬ 
tributed DOS and Windows. Since the software was sup¬ 
plied by my first notebook vendor, I was politely directed 
to contact that vendor for all technical support. Lovely: I 
guessed what chance that vendor's tech support people 
were going to have of figuring out this mysterious parti¬ 
tioning scheme problem, and I was correct. 

As it happens, I had purchased a copy of WFW 3.1 
directly from a retail store not too long before all this, and 
my 90 days of free Microsoft support on that copy had 
not yet expired. I got through to a Microsoft 'support engi¬ 
neer' using my WFW 3.1 serial number. After describing 
my problem, I told him that I considered Windows' refusal 
to configure a permanent swap file under these circum¬ 
stances to be a bug, and asked if there was a workaround 
to allow Windows to just ignore the presence of the UNIX 
partition. The engineer insisted that Windows' behavior 
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The One for Windows! 


Why buy several packages, from different manufacturers, when all you want 
to do is write a complete application? One that includes powerful rules, 
object hierarchies, database support, graphics, and a sophisticated user 
interface? That is, why buy several packages, when just one will do? 

LPA-ADK is The One! A complete Applications Development Kit, it lets you 
write entire, complex applications with the greatest of ease. Full 32-bit 
addressing means that you will never be short of space, and because 
memory handling is automatic, you don't need to worry about managing 
the resourcesyou are using: it's all done for you. LFA-ADK includes: 

O High,-level rules and objects for defining the application 

O Graphics, including vectors, fonts, bitmaps and metafiles 
O MDI, dialog, text, user, message, status and control windows 
O Full DDE support, and powerful C and DLL interfaces 
O Database access, including SQL, 0DE5C and others 

along with the programming language, function libraries and debuggers 
that you would expect from LPA, the leading Desktop Prolog House. 

Compatible versions are also available for DOS and the Macintosh ... 


... LPA-ADK is The One! 

Why not phone, fax or email LPA 
today to find out more! 


Logic Programming Associates Ltd 
Phone (US Toll Free): 1-900-949-7567 

Phone: +44 SI 671 2016 - Fax: +44 61 674 0449 
Email: lpa@cix.compulink.co.uk - CompuServe: 100135,134 
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Doughboy 

Professional Install 2.0 

for Windows 

Doughboy Professional Install uses a visual approach 
to creating installation programs and disk sets. 
Without a single line of programming, you can 
create a robust graphical setup program for your 
application. It's the easiest to use tool of its kind! 

Features of Doughboy Professional Install 2.0 

Absolutely no programming required • Built-in high 
speed data compression • Display of background 
graphic image • Full file integrity checking and error 
handling • Automatic splitting of large files across 
multiple disks • Creation of Program Manager 
groups and icons • System configuration checking • 
No royalty fees • And many more features! 

PC Magazine UK says... 

“Doughboy will cope with all but the most complex 
installations, and it's so simple and quick you'll 
recover the cost the first time you use it" (12/93) 

Stdl Only $149.00! 

1-X00-665-966Z 


NeoPoint Technologies 

P.O. Box 2281, Winnipeg, MB, Canada, R3C 4A6 
Orders (800)665-9668 Main (204)668-8180 FAX (204)661-6904 
Price is in US$. Cheque, Money Order, VISA card and approved government 
and corporate PO's accepted. Overnight delivery service available. Shipping 
charge extra. Please call or FAX for more information on our installation solutions. 

| Doughboy Professional Install Is a trademark of NeoPoint technologies. All other trademarks are property ot their respective owners 
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Listing 3 launcher.c 


LAUNCHER 1.00 

Running (Windows and) MS-DOS programs from Windows 
(0 Juan M. Agulrregabi rl a 1993 
First version 12-12-93 
Last revision 12-12-93 

,.**,**.***„. hhkk k.kkkkkk A*,*,.*** k * ********** * A* *, +*****/ 

♦include <windows.h> 

♦include <windowsx.h> 

♦include <shel1api.h> 

♦include "winrun.h" 

♦include "launcher.h" 

/*---[ Parameters ]..*/ 

♦define LENGTH 150 

/* —-.—-[ Variables ].— */ 

char szProgramCLENGTH], 
szName[LENGTH]. 
szDir[LENGTH], 
szIconfLENGTH]; 

/* -..[ Dialog procedure ].— */ 

♦pragma argsused 

BOOL ..export CALLBACK DlgProctHWND hDlg.UINT vWfcg.WPARAM wParam.LPARAM IParam) 
{ 

switch (wMsg) { 
case WMJNITDIALOG: 
return TRUE; 

case WM_COMMAND: /* Dialog box control message */ 

switch (wParam) ( 

case IDOK: /* Click on OK button */ 

Edi t_GetText(GetDl gltemthDlg,IDD_PROGRAM).szProgram,LENGTH); 
EditJSetText(GetDlgItem(hDlg,IDDJAME l.szName .LENGTH); 
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Listing 3 continued 


Edl t_GetText(GetDlgItem(hDlg.IDD_DIR l.szDir .LENGTH); 

EdT t_GetText(GetDlgltemEhDlg.IDD_ICON l.szlcon .LENGTH); 

EndDiaT og(hDlg.TRUE); 
return TRUE; 
case IDCANCEL: 

EndOlaToglhDTg,FALSE); 
return TRUE; 

) 

break; 

case WM_SYSCOHWAND: I* Message from dialog box system menu */ 

switch (wParam) { 

case SCJCLOSE; /* ALT+F4 or "Close" */ 

EndDialoglhDlg,FALSE); 
return FALSE; 

} 

break; 

) 

return FALSE; 

} 

/*--[ Main procedure ]--*/ 


#pragma argsused 

int PASCAL WinMainIHINSTANCE hlnstance.HINSTANCE hPrevInstance, 

LPSTR TpszCmdLine,int nCmdShow) 

{ 

HICON hlcon; 

if (DialogBox(hInstance,MAKEINTRESOURCE(IDD_DIALOG).NULL,DlgProc)) { 
SetCursor(LoadCursor(NULL,IDC_WAIT)): 

ShowCursor(TRUE): 

hlcon = (*szIcon) ? ExtractIcon(hInstance,szIcon,0) ; NULL; 
if (hlcon = (HICON)l) hlcon = NULL; 
WinRunCszProgram.nCmdShow.hlnstance, 

(*szName) ? szName : NULL,(*szDir) ? szDir ; NULL.hlcon); 
if (hlcon) Destroylcon(hlcon); 

SetCursor (LoadCursor( NULL. IDCARROW)); 

ShowCursorl FALSE); 

) 

return 0; 

} 

/* End of File */ 


here was not a bug, and Microsoft didn't support Win¬ 
dows running in conjunction with other operating systems. 
I tried to explain that Unix wasn't actually running, it was 
just sitting there on some non-DOS disk tracks, and Win¬ 
dows should treat it exactly as if those tracks were unused 
disk space. The argument was lost on him, and ultimately 
I lost that battle. 

My final attempt to bring this issue to Microsoft's atten¬ 
tion was to contact Waggoner-Edstrom, Microsoft's PR 


agency. The nice people there assured me I was indeed 
going through the appropriate channels to report a possi¬ 
ble problem with the operating system software, and 
they'd have an engineer contact me soon. That was sev¬ 
eral months ago, and I still haven't been contacted by 
anyone from Microsoft about it. 

In the midst of wrestling with this issue, I happened to pay 
a visit to my favorite hardware retailer and described my frus¬ 
tration over this behavior of Windows to an employee there. 


C and C++ DOCUMENTATION 


C-METR^fSS^ COMPLEXITY/QUALITY 

• Calculates cyclomatic path complexity for functions and 


path complexity 1 

■ Counts lines with comments, code, and C statements 


system 


filel 

main 

file2 

—sub2 

flle2 

1—sub3 

file2 

1—sub4 

filel 

—main {recursv} 


— Ibryl, Ibry2 


C-CALL ($69) FVNCTIQN HIERARCHY 


• Tree-Diagram showing function hierarchy 
■ Table-Of-Contents of functions versus files 

• Summary and detailed cross-reference of functions 




■C-QM.MENI 


Generates and inserts function comment blocks 

• Can be re-run to update the comment blocks 

• Retains any user-generated comments 


while (i<j) 

if(i<k) { 


1 


^exitJO^ 


TFF************************* 
sub2 USERS: main 

CALLS: sub3 sub4 
PARAM: argl arg2 
LOCAL: varl 
GLOBL: var2 var3 


C-LIST1S69) lists or reformats 

• Action-Diagrams show logic/control flow 

• Optional line numbers, page numbers, and titles 

• Reformats source to various standardized formats 


C-REF ($59) CROSS-REFERENCES IDENTIFIERS 


1 Local/parameter/global/define summary or cross-reference 
• Produces class-hierarchy tree-diagram for C++ classes 

SPECIAL: ($199) C-DOC™ DOS Package ($325 Value) 


• All 5 programs fully integrated as 1 overall C-bOC program 

• Processes multiple directories/files up to 15,000 total lines 

• Unconditional 30-day money-back guarantee of satisfaction 

NEW: C-DOC “Professional ($299): DOS. OS/2. Windows 

• Processes 150,000 lines, 3-ring binder/case, 2-pass deferred reports 


!! NEW 5.0 !! Point-and-click G.U.I. operation !! 


SOFTWARE BLACKSMITHS INC 

6064 St Ives Way, Mississauga Voice/Fax: (9051-858-4466 

ONT Canada L5N-4M1 Demo/BBS: (905)-858-1916 
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MS dos System 
Programming 

2nd Edition 


Edited by Robert Ward 
NOW—You can get the informa¬ 
tion most programmers don’t 
even know about. 

PLUS -Gain access to a critical 
bibliography that will become an 
indispensible resource to you. 

HIGHLY TECHNICAL 
HIGHLY FOCUSED 


Second edition 


MS-dos 

system programming 


Every entry is written by 
working programmers for 
working programmers. In¬ 
cluded are compiler- 
specific insights that will 
save you hours of work. 

Find out how to exploit spe¬ 
cial Turbo C features to 
simplify device drivers. Plus 
a bibliography designed to 
help the serious program¬ 
mer develop a personal 
library of MS-dos literature. 

Released July 1991, 240 pp. ISBN 0-923667-20-2 

DIRECTLY Windows/DOS 

FROM g 1 


edited by 

ROBERT WARD 


Nitty Gritty Coverage on 
These How-to Topics 


Critical Error Handling 
Customizing the DOS 
Boot Strap 
Interrupt-Driven I/O 
Manipulating 
Environmental Variables 
Event Timing 
Writing TSRs 
Controlling the Disk 
Hardware 
Writing Device 
Drivers 
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913 - 841-1631 

FAX: 913-841-2624 


$ 24 » 
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The employee immediately suggested a solution to which 
my tunnel-vision ('Get Microsoft to admit this is a bug!') 
must have blinded me: use Norton Utilities to save an im¬ 
age of the hard disk's partition table to a file. Then, any 
time I need to make a change to the Virtual Memory Set¬ 
tings, just run fdisk to 'delete' the UNIX partition (which 
really just alters the partition table), make the Virtual 
Memory changes, and then restore the original partition 
table from the saved file! 

After dusting off diskedit from Norton Utilities 6.01, it 
was a simple matter to select the Par¬ 
tition Table from the Object menu 
and save the image to a file. Of 
course, the first time I did this I used 
a test-bed system (having to re-install 
SCO UNIX from floppies was not 
something I wanted to face!) to verify 
that I could, indeed, restore an exist¬ 
ing partition from such a backup im¬ 
age file after "deleting' the partition 
using fdisk. 

As far as I know, no one at Mi¬ 
crosoft is particularly concerned 
about the confusion and hassle this 
little 'feature' of Windows can cause. 

If there's anyone else out there who 
runs both UNIX and Windows on the 
same machine, I'd be curious to 
know if this issue has come up for 
you and how you've dealt with it... 

Quick-and-Dirty Printer 
Configuration 


type nul \empty.bat 

Now, you're all set to make the PROMPT command work for 
you to send escape sequences to PRN, LPT2, files, wher¬ 
ever. For an Epson-emulating printer, ESC xl sets quality 
print and ESC x0 resets to draft. As a demonstration, say 
you want to send the text 'Quality' in quality mode, fol¬ 
lowed immediately by the text 'Draft' in draft mode. First, 
enter this command: 

(continued on page 58) 



Homer Tilton 


Yours truly being a confirmed DOS 
squeezer, Laura Michaels' tips in the 
April issue, 'Squeezing Some Water 
from the DOS Rock,' made my spine 
tingle. And they reminded me of one 
I discovered after some intense 
squeezing. 

Years ago one of the first DOS 
books I read told how to reassign 
keys under ANSI.SYS by sending es¬ 
cape sequences to CON using the 
PROMPT command. But all attempts to 
redirect similar commands to PRN for 
setting printer attributes failed until I 
recently found the simple secret, as 
follows. 

You need to initially have a totally 
empty batch file for this to work 
properly. For example, you can make 
one with: 


Listing 4 launcher.rc 


I *****************************************************************■*:*★★★******** 

LAUNCHER.RC 

(0 Juan M. Aguirregabiria 1993 
First version 12/12/93 
Last revision 12/12/93 


******************************************************************************/ 

#ifndef WORKSHOPJNVOKED 
#include “windows.h” 

#include "ver.h” 

#endif 

#include "launcher.h" 

IDDJIALOG DIALOG -32768, 18. 216, 90 

STYLE DS_MODALFRAME I WSJVERLAPPED I WSJISIBLE I WSJAPTION I WS_SYSMENU 
CAPTION "Launcher” 

FONT 8. "Helv” 

BEGIN 

LTEXT "SCommand line:", -1. 7, 7, 50. 8, WSJHILD I WSJISIBLE I WSJROUP 
EDITTEXT IDD_PROGRAM. 60, 5. 151. 12. ESJEFT I WSJHILD I WSJISIBLE I WSJORDER I WS_TABSTOP 
LTEXT "iTitle:", -1, 7, 21, 50, 8. WSJHILD I WSJISIBLE | WSJROUP 
EDITTEXT IDDJAME, 60, 19, 151, 12. ESJEFT I WSJHILD | WSJISIBLE I WSJORDER I WSJABSTOP 
LTEXT "SDirectory:", -1, 7. 35, 50, 8, WSJHILD I WSJISIBLE I WSJROUP 
EDITTEXT IDDJIR, 60, 33, 151, 12, ESJEFT I WSJHILD I WSJISIBLE I WSJORDER I WSJABSTOP 
LTEXT "ilcon file:", -1, 7, 49, 50, 8, WSJHILD I WSJISIBLE I WSJROUP 
EDITTEXT IDDJCON. 60, 47. 151, 12. ESJEFT I WSJHILD I WSJISIBLE I WSJORDER | WSJABSTOP 
DEFPUSHBUTTON "OK", IDOK. 40, 67, 50, 16. WSJHILD I WSJISIBLE I WSJABSTOP 
PUSHBUTTON "Cancel”, IDCANCEL, 118, 67. 50, 16, WSJHILD I WSJISIBLE I WSJABSTOP 
END 


Listing 5 launcher.def 




***************************************************************************** 

LAUNCHER.DEF 

(C) Juan M. Aguirregabiria (1993) 

First version 12/12/93 
Last revision 12/12/93 

**************************************************************************** 

NAME LAUNCHER 

DESCRIPTION 'Simple program launcher (C) 1993 Juan M. Aguirregabiria’ 

EXETYPE WINDOWS 

STUB 'WINSTUB.EXE' 

CODE PRELOAD MOVEABLE DISCARDABLE 

DATA PRELOAD MOVEABLE MULTIPLE 

HEAPSIZE 2048 

STACKSIZE 5120 
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PROMPT SExlQuality $Ex0Draft 


Then enter this command: 
COMMAND /C \EMPTY PRN 


and bam! you're done. Watch the printout. How does it 
work? Remember how the prompt repeats on screen 
when you don't put 'echo off' at the start of your batch 
file? That's exactly what happens here, but now COMMAND /C 
sends the result to the printer. Try it, you'll like it! □ 


Listing 6 launcher.mak 


.AUTODEPEND 

# ‘Translator Definitions* 

CC = bcc +LAUNCHER.CFG 

TASM = TASM 

TLIB = tlib 

TLINK = tlink 

LIBPATH = e:\bc4\lib 

INCLUDEPATH = e:\bc4\include 


# ‘Implicit Rules* 

.c.obj: 

$(CC) -c {$< } 


winrun.obj \ 
launcher.def 


# ‘Explicit Rules* 

launcher.exe: launcher.cfg $(Link_Include) $(Link_Exclude) 
$(TLINK) /v/x/c/P-/Twe/L$(LIBPATH) @M| 
c0ws.obj+ 
launcher.obj+ 
winrun.obj 
launcher 

# no map file 

+ 

import.lib cws.lib 
launcher.def 


cpp.obj: 

$(CC) -c {$< } 


RC launcher.res launcher.exe 


# ‘List Macros* 

Link_Exclude = \ 
launcher.res 

Link_Include = \ 
launcher.obj \ 


Build your C skills with 
programming books from 



PLUM HALL 


Learn how to use the 
power of C: pointers, 
files, and structures, 
includes complete case 
study programs for 
sorting, simulating and 
more. 

Y85.$29.95 


Learning 
Program in 

C ' 


Tom Plum guides you 
through portable C 
programs for the full 
spectrum of processors, 
mini, micro, and 
mainframe. 


Y81.$29.95 



publications, inc. 


CALL 

913 - 841-1631 

TO ORDER 

FAX 913-841-2624 


# ‘Individual File Dependencies* 

launcher.obj: launcher.cfg launcher.c 

winrun.obj: launcher.cfg winrun.c 

launcher.res: launcher.cfg launcher.rc 

RC -R -1$(INCLUDEPATH) -F0 launcher.res LAUNCHER.RC 


# ‘Compiler Configuration File* 

launcher.cfg: launcher.mak 
copy Ml 

-2 

-a 

-f- 

-K 


-v 

-G 

-0 

-0g 

-Oe 

-0m 

-0v 

-01 

-Ob 

-Op 

-Oi 

-l 

-k- 

-d 

-WE 

-vi- 

-H=LAUNCHER.SYM 

-wpro 

-weas 

-wpre 

-I$(INCLUDEPATH) 
-L$(LIBPATH) 
-DSTRICT 
-P-.C 

I launcher.cfg 
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Ron Burk 


Dynamic Function Calls 



Borland C++ v4.0 
Symantec C++ v6.1 
Visual C++ vl .5 


This is the ninth in a series of columns about the design and implementa¬ 
tion of WUIMAN (a Windows User Interface MANager). Unlike other GUI-build- 
ing tools under Windows, WUIMAN links with your application and allows you 
(or even end users) to create, modify, and extend your user interface (which is 
described by a simple tree-structured database) at any time - there is no test 
mode, since your application and its user interface are 'live' at all times. This 
installment describes the code WUIMAN uses to construct function calls dy¬ 
namically at runtime. 

Dyna-Calling 

Like Visual Basic, WUIMAN supports the concept of events, the ability to 
arrange for functions in your application to be called when certain user inter¬ 
face events (such as mouse clicks) occur. Unlike Visual Basic, WUIMAN is meant 
to be flexible enough that you can specify the arguments your event-handling 
function gets passed. All this requires the ability to construct function calls at 
runtime. C++ function pointers let you decide which function to call at runtime, 
but they don't let you change your mind about how many parameters to pass 
to it. C++ does not support any portable method for calling arbitrary functions 
with an arbitrary number of parameters of arbitrary type, but that is just the 
capability that WUIMAN needs in implementing events. 

I'm not sure exactly how WUIMAN's events will look to the calling applica¬ 
tion yet, but the low-level capabilities I need are fairly clear. At the most primi¬ 
tive level, I will have a pointer to a function and an array of pointers to argu¬ 
ments to that function. I will also need to know how many bytes long each 
argument is. Given that data, I will have to push the arguments onto the stack, 
just as a compiler-generated call would, and then execute a call through the 
function pointer. Finally, I need some way of dealing with different function 
return types (char, int, etc.), since the return type may also vary at run time. 


Ron Burk is the editor of Windows/DOS Developer's Journal and has been a program¬ 
mer for 72 years. You may contact him at Burk Labs, P.O. Box 3082, Redmond, WA 
98073-3082. CIS: 70302,2566. Internet: ronb@rdpub.com (" . . . iuunetlrdpublronb”). 











Listing 1 w_dycall.h — Dynacall declarations 


II w_dyca11.h - declarations for dynamic calling class 

#ifndef W_DYCALL_H 
#define W_DYCALL_H 

#if !(defined(_INC_WINDOWS) II definedi_WIND0WS_H)) 

#include <windows.h> 
i/endi f 

class TDynaCall 
( 

public: 

union RESULT 
{ 

char Char; 

int Int; 

long Long; 

void ‘Pointer; 

}; 

enum { MAXARGS = 32, MAXARGLEN = 128 }; 
static RESULT Cal 1(FARPROC Function, int NArgs, 

int ‘Widths, void “Pointers, 
int Reversed, int Ds=0); 

private: 

static long Call(FARPROC Function, const char *Args, 

int Length, int Ds=0); 

}; 

#endif // W_DYCALL_H 
/* End of File */ 


Listing 2 w_dycall.c — Dynamic function calling 
code 


II w_dycall.c - implement dynamic calling class 

#include <string.h> 
find ude "wuistd.h" 

#i nclude "w_dycal1.h" 

I *********************************************************** 

TDynaCall::Call() • execute dynamic function call. 
Description: 

The input is an array of pointers to arguments and a 
parallel array of argument widths (the latter has an 
extra element equal to zero, to denote the last argument). 
You can also optionally supply a value to set the DS (and 
AX) to before executing the call. 

The Intel 80x86 stack grows downward, and SP points to 
the last used stack cell, not the next available cell. 

★♦★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★•A - *** i 

TDynaCall::RESULT TDynaCall::Call(FARPROC Function. 

int NArgs, int ‘Widths, void “Pointers, 
int Reverse, int Ds) 

{ 

ASSERTtFunction 1= NULL); 

ASSERTtNArgs >= 0); 
if(NArgs > 0) 

{ 

ASSERT(Widths 1= NULL); 

ASSERT(Pointers 1= NULL); 

ASSERT(NArgs <= 32); 

} 

int AdjustedWidths[MAXARGS]; 

RESULT Result; 

int StackSize = 0; 


The main trick here is how to get arbitrary data copied 
onto the stack, making sure the stack pointer is incre¬ 
mented past the last argument before you execute the 
function call. The book Undocumented Windows contains a 
shell that lets you interactively construct and execute calls 
to arbitrary DLL functions, which is almost exactly the 
functionality I am trying to construct here. It uses a clever 
trick to get data pushed on the stack without resorting to 
assembly language: it passes data of the desired size (it 
supports only a few argument sizes) to a single function 
whose calling sequence is declared of type PASCAL and 
which is declared to take no arguments. The compiler 
generates code to push the argument on the stack, but 
the function being called does not pop any arguments be¬ 
fore returning. Thus, the function call has effectively 
pushed an argument on the stack. 

I avoided this trick for a couple of reasons. First, I 
wanted to allow more than a few set sizes (1 -byte, 2-byte, 
4-byte, 8-byte) of arguments to be passed. Second, I 
wanted to make the code as clear as possible, and as un¬ 
likely to break during maintenance as possible. My strat¬ 
egy was to keep as much of the code in C++ as possible 
(even at the expense of efficiency) and isolate all the as¬ 
sembly code in a single function. Even so, it took me sev¬ 
eral hours to get the code right. 

Intel 80x86 Calling Sequences 

Two main calling sequences are in use in the Windows 
environment and I wanted to support them both. With the 
Pascal calling sequence (used by most exported DLL func¬ 
tions), arguments are pushed on the stack from left to 
right. With the C (or 'cded') calling sequence, they are 
pushed on from right to left (a convenient order for a lan¬ 
guage that supports functions that accept a variable num¬ 
ber of arguments). The 80x86 stack is aligned on either 
2-byte or 4-byte boundaries, depending upon the proces¬ 
sor and its current mode; I will assume 16-bit code. An¬ 
other consideration was the fact that the stack grows 
downward in the Intel 80x86 environment, so each argu¬ 
ment is placed at successively lower locations in memory. 
A final factor was that some functions expect the caller to 
place the correct value for their DGROUP in the AX or DS reg¬ 
ister before calling them (discussed in more detail later). 

w_dycall.h (Listing 1) contains the interface I con¬ 
structed for my low-level dynamic function calling routine. 
You pass it a function pointer, the number of arguments, 
two parallel arrays of argument sizes and pointers, a flag 
(optional) that specifies C or Pascal calling conventions, 
and an optional value to set both AX and DS to before 
executing the call. The code that does all the work is in 
w_dycall.c (Listing 2) and is split into a C++ function and a 
function that contains only inline assembly. 

I placed some restrictions on the number of arguments 
and their maximum sizes, not to save memory, but in or¬ 
der to do some rudimentary sanity checks on the argu¬ 
ments, since passing bad arguments to this function can 
be disastrous. The public function allocates dynamic mem¬ 
ory in which it constructs an exact image of what it wants 
the stack to be; I was trying to keep the separate inline 
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assembly function as small as possible. This implementa¬ 
tion is for 16-bit Windows, so it aligns arguments on 2- 
byte boundaries as it constructs the stack image. 

The inline assembly code is fairly simple, but the first 
version contained a bug that provided hours of entertain¬ 
ment. I verified in the debugger that I had both the source 
and destination pointers set up correctly, but after the rep 
movsu instruction was executed, the destination did not 
contain the source string. To figure this out, I even added 
the following code: 

mov ax,0 
mov es:[di],ax 
mov ax.es:[di] 


Listing 2 continued 


// first, figure total stack required 
fordnt i =0; i < NArgs; ++i) 

{ 

// Sanity checks 

ASSERTtWidths[i] > 0 M Widths[i] < MAXARGLEN); 

int ArgWidth = Widthsfi]; 

int Remainder = ArgWidth H sizeof(int): 

iftRemainder 1= 0) // if not even with alignment 
// then round up to alignment size 
ArgWidth += sizeof(int)-Remainder; 
AdjustedWidthsfi] « ArgWidth; 

StackSize += ArgWidth; 


To my amazement, executing these 
instructions did not leave AX equal to 
zero! Much later, I realized that I was 
adjusting the SP past the new argu¬ 
ments after copying to the stack, 
rather than before. That meant that I 
was copying the source string into an 
area of the stack that would be 
trashed by any incoming interrupts, 
most notably, the interrupts the de¬ 
bugger was using to single-step my 
program. 

Return Values 

In both C and Pascal calling se¬ 
quences, the convention is to return 
one-, two-, or four-byte values in AL, 
AX, or DX-.AX, respectively. That makes 
it fairly easy to handle data types of 
char, int, long, and pointer types, 
which is sufficient for the vast major¬ 
ity of functions. I simply define a un¬ 
ion of these types and leave it up to 
the caller to extract the particular 
data type that the callee is supposed 
to be returning. 

Why have I passed over the built- 
in data types of float and double ? I 
have a rule of thumb that covers a 
lot of Windows programming situ¬ 
ations: 'If very few programmers use 
it, it probably doesn't work right.' In 
this case, only a small percentage of 
Windows programmers regularly use 
floating point, so compiler vendors 
have been able to get away with cre¬ 
ating completely incompatible imple¬ 
mentations. Specifically, no one 
agrees on how to return floating 
point numbers, as I will demonstrate. 

Here is a simple function that re¬ 
turns a floating-point number: 

float_export Food 

{ return 1.0; } 
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I compiled this as a large-model DLL and dumped the 
code that each of three C++ compilers produced. Borland 
C++ v4.0 produced the following code (stripped of pro¬ 
logue and epilogue instructions): 

fldl 

Borland places the return value in the floating-point accu¬ 
mulator (which is simply a global variable if you are using 
emulator code, as most DLLs would). Symantec C++ v6.1 
produced the following code: 

xor ax,ax 
mov dx,03F80h 

Despite claiming to be highly Microsoft-compatible, Sy¬ 
mantec places the return value in DX-.AX (a most sensible 
choice, in my opinion). Here is the rather voluminous code 
produced by Visual C++ vl.5: 


fid float ptr DGROUP:CONST[00h] 

fstp float ptr _fac 

nop 

wait 

mov AX,offset fac 

mov DX,DS 

Microsoft has chosen to return a far pointer to the return 
value in DX-.AX. 

There you have it: three compilers and three com¬ 
pletely incompatible methods for returning float values. 
These are not just benign incompatibilities, either. If you 
compile the simple function just shown into a DLL with 
Visual C++ vl .5 and then call it from an application com¬ 
piled with Borland C++ v4.0, the application will die with 
a hard error ('Floating point: Stack underflow'), i suppose I 
could make WUIMAN flexible enough to allow the pro¬ 
grammer to specify which compiler compiled the function 


Listing 2 continued 


} 

// now make contiguous copy of args 
char *Args = new char[StackSize]; 

// first stack loc is at highest mem loc 
// (because stack grows down) 
char *Stack = Args + StackSize; 

int Start = 0; 
int Step = 1; 

if(Reverse) // if C calling sequence 

{ 

Start = NArgs-1; 

Step = -1: 

1 

// construct image of stack 
for(i=Start; i >= 0 && i < NArgs; i+=Step) 
{ 

A$SERT(Pointers[i] ! = NULL); 

// back up (stack grows down) 

Stack -= AdjustedWidths[i]; 
memcpy(Stack, Pointers[i], Widths[i]); 
1 


{ 

int SaveSp, SaveDs; 


// Save current value of stack pointer, so we can restore 
// it later (pray that caller does not trash bpl). 

_asm mov ax,sp 

_asm mov SaveSp,sp 

_asm mov ax,ds 

_asm mov SaveDs,ax 


asm Ids si,Args // ds:si <- ptr to source 
asm mov ax.ss 
asm mov es,ax 

asm mov di,sp // es:di <- ptr to destination 

asm sub sp,StackSize // adjust stack pointer now, else 
// stack space we write to is 
// fair game for interrupts 


asm sub di.WORDSIZE // due to the nature of sp 
asm sub si.WORDSIZE 


asm mov cx.StackSize 

asm shr cx,(WORDSIZE/2) // # of words to move 


// now let subfunction do the assembly work 

Result.Long = Call(Function, Args+StackSize, StackSize, Ds); 

delete[] Args; 

return Result; 

} 


_asm jcxz CopyDone 
_asm std 

_asm rep movsw 

_asm cld 

CopyDone: 


/* 

* Call - Handle assembly language part of call. 

* 

* Description: 

* The goal is to keep all the assembly language in this 

* function and to keep it as simple as possible. It saves 

* and restores some registers across the call (most importantly, 

* SP and DS) rather than depending on the caller. 

*/ 

(/define WORDSIZE (2) 

long TDynaCal1::Call(FARPROC Function, 

const char *Args, int StackSize, int DsReg) 


_asm mov ax,DsReg 

_asm mov ds.ax 

_asm call Function 

_asm mov bx,SaveDs 

_asm mov ds,bx 

_asm mov sp,SaveSp 

} 

/* End of File */ 


// install desired DS 

// finallyt!) call function 
// restore DS reg 

// restore SP reg 
// return dx:ax 
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Listing 3 condbug.c —- Demonstrating Borland’s ?: 

bug 


#include <stdio.h> 

void maindnt argc, char **argv) 

{ 

int a=0, b=0: 
int c= (argc > 1); 
c?a:b = 1; 

printft "a=%d, b=*d, c=M\n", a, b, c); 
(c?a:b) = 1; 

printft "a=%d, b=%d, c=Jd\n", a, b, c); 
} 

/* End of File */ 


being called, but that's too much work at this stage of the 
game. Someday, perhaps the various C++ compiler ven¬ 
dors will standardize on a single calling sequence. For the 
foreseeable future, though, DLLs will remain hostile envi¬ 
ronments to anyone who wants to write vendor-inde¬ 
pendent C++ code. 

As a side note, the example I used is for the C++ call¬ 
ing sequence. If you switch to a Pascal calling sequence, 
then both Microsoft and Symantec require the caller to 
pass the address of a stack variable that the callee copies 
the return value into. Borland still uses the floating point 
accumulator, so it is still impossible to write vendor-inde¬ 
pendent code. 

Instances and All That 

The tinkering my code does with the DS register de¬ 
serves some explanation. DLLs introduce complications for 
dynamic function calling. The caller might be in an appli¬ 
cation while the callee is in a DLL, or vice versa. If the 
callee is in an application, it may or may not have been 
exported. Instances, exports, calling sequences - these 
can all make your head hurt in short order, but there is a 
fairly simple way to look at the problem. 

Any function expects to be able to access static data 
that resides in its DGROUP, which is another way of saying 
that all functions need DS to be set to the correct value for 
their code. There are four cases. First, a function that is 
not exported simply expects that DS already contained the 
correct value before it was called. Second, an exported 
function can require that the caller set AX to the correct 
value of DS before calling it (MakeProcInstanceO generates 
code that does this for you). Third, an exported applica¬ 
tion function compiled with a 'smart callbacks' option sim¬ 
ply saves the current DS, loads DS from the 55, and then 
restores the previous DS before returning (this trick relies 
on the fact that an application's stack and DGROUP reside in 
the same segment). Fourth, an exported DLL function just 
saves the current DS, sets DS equal to DGROUP, and then re¬ 
stores the previous DS before returning (in opposition to 
an application, a DLL might have many stacks, but it al¬ 
ways has exactly one DGROUP). 

Examining these four possibilities leads me to the fol¬ 
lowing conclusion. If I set both DS and AX to the correct 
value before calling a function, then the call will work cor¬ 


rectly no matter which of the four calling sequences the 
callee is using. That is handy because it means I can place 
the burden of managing instances on WUIMAN, so the 
application never has to worry about exporting functions 
that WUIMAN may call at runtime - WUIMAN will work 
correctly whether the application callback function is ex¬ 
ported or not. When calling a DLL function, WUIMAN can 
assume it will set DS correctly on its own. For DLL func¬ 
tions, I will set DS to zero before executing the function 
call, just as a safety measure to reduce the damage that 
an improperly constructed DLL function can do to the 
caller. Another safety measure I take is to always save 
and restore the SP myself across the call. The Pascal call¬ 
ing sequence should restore the correct value of SP, but 
this extra step defends against disaster when the caller 
and callee disagree on the number of arguments (and I 
have to do this to support the C calling sequence anyway). 

Bug++ of the Month 

In the March installment of this column, I described Mi¬ 
crosoft's faulty implementation of pointers to member 
functions. C++ is a complex and new enough language 
that it is still fairly common to find instances where a 
given compiler has failed to implement the language 
specification properly, even in areas where the specifica¬ 
tion has been stable for years. Lest anyone think that Mi¬ 
crosoft is the only one who misses the mark, this month's 
award goes to Borland C++ v4.0 for its failure to imple¬ 
ment the conditional operator correctly. This bug has ap¬ 
parently been in Borland C++ for quite some time, but I 
stumbled on it only recently because of my attempts to 
more easily debug WUIMAN's code. 

I use a lot of assertions in WUIMAN and I also use 
Bounds-Checker for Windows (BCHKW) to perform some 
kinds of automatic bug detection. You just load your appli¬ 
cation with BCHKW and it sits in the background, monitor¬ 
ing calls to the Windows API and popping up if it encoun¬ 
ters an error - sort of an automated source-level debug¬ 
ger. It sure would be nice if BCHKW would get control 
whenever my software failed an assertion, just so I could 
quickly look at the symbolic stack trace to get a better 
idea of how the assertion failure arose. Unfortunately, 
BCHKW does not know anything about assertion failures, 
and does not give me the ability to break on a particular 
function call (such as FatalAppExitO). One day I got irri¬ 
tated at this shortcoming in BCHKW and tried to come up 
with a workaround. 

I decided I would fool BCHKW into doing what I 
wanted by doing something illegal whenever an assertion 
failed. BCHKW should then pop up and I would be able to 
view a symbolic stack trace. I first tried calling Debug- 
BreakO, a Windows API function that causes a breakpoint 
exception. Since there is no reason for BCHKW to perform 
parameter validation on this function (it takes no argu¬ 
ments and returns no value), I figured a call to Debug- 
BreakO would make BCHKW pop up. Unfortunately, 
BCHKW does not pop up if you call DebugBreakO, so I 
opted for more drastic action, like so: 
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//define ASSERT(e) ((e)?(void) 0:\ 

((void)GlobalLock(0).assert(e))) 

This did the trick, as passing GlobalLock!) a NULL selector 
definitely gets the attention of BCHKW; it popped up and 
let me view a symbolic stack trace at the point where the 
exception occurred. 

There is a problem with my quick hack, though - it 
causes the expression being asserted to be evaluated 
twice. That turned out to be a bug I was able to ignore for 
some time, until one day I went to recompile my very 
simple regression testing program with Borland C++ v4.0. 
Suddenly, I was deluged with compiler error messages like 
this: 

Destructor for TWuiName required in 
conditional expression. 

TWuiName is a WUIMAN class that gets called a lot; it is a 
reference-counted string class used for all object names 
within WUIMAN. The problem was that some of my asser¬ 
tions in the regression testing code looked like this: 

TWuiName X; 

II... 

ASSERT( X == "TestName" ); 


Due to the definition of TUuiName and ASSERTO, this ex¬ 
panded into a statement that required the compiler to cre¬ 
ate a temporary TUuiName object (it had to convert the 
string to a TUuiName object to do the comparison) in the 
operand of a conditional expression. 

Now I at least understood how the conditional opera¬ 
tor and a temporary object were involved, but still had no 
clue why the compiler was complaining. Next, I turned to 
Borland's printed documentation, which contains the fol¬ 
lowing explanation for this error message: 

If the compiler must create a temporary local variable in a 
conditional expression, it has no good place to call the de¬ 
structor, because the variable might or might not have 
been initialized. The temporary variable can be explicitly 
created, as with classnametval,val), or implicitly created by 
some other code. Recast your code to eliminate this tem¬ 
porary value. 

Pure hokum. In the early days of C++, the AT&T C++ 
compiler would regularly produce error messages of the 
form 

Sorry, ’feature x’ not implemented yet. 

to indicate an area of the language that the compiler was 
not yet up to snuff on. Unfortunately, in the highly com¬ 
petitive PC C++ compiler market, it is unacceptable to ad¬ 
mit of any defects or shortcomings, so both Borland and 
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Microsoft emit error messages designed to convince you 
that your code is in error, when in fact the error is in their 
compilers. The truth here is that C++ places absolutely no 
restrictions on the use of class temporaries in conditional 
expressions - if the compiler needs a temporary, it is the 
compiler's job to generate it and see that it is destroyed. 
Borland C++ v4.0 (and version 3.1 and possibly earlier 
versions as well) simply does not handle this legal con¬ 
struct. Neither Visual C++ vl.5 nor Symantec v6.1 has this 
bug (apparently their compiler designers managed to find 
a 'good place to call the destructor'!). 

In the case of Visual C++'s incorrect handling of point¬ 
ers to members, one bug meant that another was lurking. 
That was the case here, too, and within a few weeks I ran 
into another Borland bug involving the conditional opera¬ 
tor. One of the gratuitous little differences between C and 
C++ is that in C++ the result of a conditional expression is 
an lvalue (something that can be assigned to) if both of its 
operands are lvalues of the same type. 

Consider the code in condbug.c (Listing 3). It is not a 
legal C program because the conditional operator binds 
tighter than assignment and, in C, the result is not an 
lvalue. It is, however, a legal C++ program - a value of 7 
gets assigned to either a or b, depending upon the value 
of c. This program should always produce two identical 
lines of output because the parentheses in the second 
conditional operator merely explicitly express the default 
binding of the language. Under Borland C++ v4.0, how¬ 
ever, this program can produce two different lines of out¬ 
put! The compiler apparently incorrectly binds the first 
conditional operator as: 

c?a:(b = 1); 

On the one hand, this construct is unlikely to arise in a 
significant percentage of C++ programs. On the other 
hand, binding a legal expression incorrectly is a pretty se¬ 
rious goof for any compiler. Neither Microsoft nor Syman¬ 
tec C++ compilers have this bug. 

Summary 

Unlike Microsoft and its incorrect implementation of 
pointers to member functions, Borland has acknowledged 
these problems, so at least there is some hope (but no 
specific promise) that the language bugs cited here will get 
fixed in the next release of Borland C++. It is sobering to 
consider that all the C++ compiler bugs I have presented 
so far in this column have arisen from a single, one-pro¬ 
grammer project (WUIMAN). PC C++ compilers have a 
long way to go before you can casually rely on them to 
compile, let alone produce correct code, for all legal C++ 
programs. 

This month's code disk has the complete WUIMAN 
source for the project to date, including code from past 
issues. The code disk is widely available via sources listed 
in the table of contents. □ 
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Lawrence, KS 66046-2700. 

Paul answers all electronic 
communications but is unable to 
respond personally to hard copy/disk 
messages. 


Q l have two questions and a GDI bug. First, I have an MDI application, and 
if the user clicks on an inactive window, I want to activate it but not 
change the selection. The documentation implies that I should be able to ac¬ 
complish this by returning MA_ACTIVATEANDEAT when the MDI child window re¬ 
ceives the UM_M0USEACTIVATE message, but this results in all mouse clicks being 
eaten, not just those on an inactive MDI child. 

Second, is there a way to block an overlapped window from showing up in 
the task list? I'm doing my own dialogs using top-level windows (blocking mes¬ 
sages as necessary, not as hard as it sounds) and I would rather not see them 
when I Alt-Tab or CTRL-ESC. 

The GDI bug I mentioned occurs when you call CreateRoundRectRgnO and the 
rectangle is either empty (left=right or top=bottom) or the width or height of 
the rectangle is smaller than the width or height of the ellipse. In either case, 
Windows GP faults. 

Chris Mason 
CIS: 73003,3101 

A As you have discovered, the interaction between the window manager 
and the MDI manager is somewhat of a mess (things have gotten a lot 
better since Windows 3.0; even so, neither Excel nor Word for Windows uses 
the MDI API). MDI windows do not behave as advertised when processing the 
UM_M0USEACTIVATE message. One problem is that it is not possible to prevent the 
child MDI window from being activated; MA_N0ACTIVATE has no effect and 
MA_NOACTIVATEANDEAT eats the click but allows the window to become active. Also, 
as you have seen, the UM_M0USEACTIVATE message is sent before every mouse 
click, whether the MDI child becomes active or not. 


Paul was a developer of HyperChem, a molecular modeling system, and more recently, 
of Creative Writer, a word processor for children. He works for Microsoft Corporation as 
a Software Design Engineer. The opinions expressed in this column are Paul's alone 
and not those of Microsoft. 























Listing 1 Code to transform client click to menu 
click 


/*****************************************************/ 
/* mdiclick.c */ 

/* -- Control mouse clicks when activating an mdi */ 
/* window. */ 

/*****************************************************/ 
#include <windows.h> 


LRESULT LwHandleHitTest(HWND hwnd, HWND hwndClient. 

WPARAM wParam. LPARAM 1Param) 
/*****************************************************/ 


/* 

/* 

/* 

/* 

/* 

/* 


Handle a WM_NCHITTEST message on an MDI child 
window to suppress WM_LBUTTONxx messages when 
an inactive window is clicked. 


hwnd 

hwndClient 
wParam, IParam 


MDI child window. 
MDI client window. 
Message parameters. 


^★★★★**★★★***★★★**★★★★*★★**★**★**★**★*★***★★***★*★*★★* j 


{ 

LRESULT lVal; 


lVal = DefMDIChi 1 dProcIhwnd, WMJCHITTEST, wParam. 
IParam); 

if (GetAsyncKeyState(VK_LBUTTON) < 0 M 
(HWND)LOWORDISendMessagelhwndClient, 
WM_MDIGETACTIVE, 0, 0)) 1= hwnd && 
lVal == HTCLIENT) 
return HTMENU; 


return lVal; 

} 

/* End of File */ 
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A better solution to your problem is to use the MM_NCHIT- 
TEST message to control the MDI child's behavior. This mes¬ 
sage is sent by the window manager whenever the mouse is 
moved or clicked in a window. The return value is one of 24 
possible HTxxx constants in windows.h, and it tells the window 
manager how to treat the click. The value specifies if the 
click is in the client area (HTCLIENT), is in the non-client area 
(20 constants identifying which part of the non-client area, 
ranging from HTCAPTION to HTZOOMi, is to be ignored (HTNOMHERE), 
is to be ignored and cause a beep (HTERROR), or is to be 
passed on to the parent window (HTTRANSPAREN'T). 

My idea is to transform a client click on an inactive 
MDI child into a do-nothing menu click. The result will be 
that the MDI child gets activated, but no MM_LBUTT0ND0HN 
message will be generated, and so the selection will be 
preserved. So if a MM_NCHITTEST message is received for an 
inactive window when the mouse button is down, first 
pass the message to DefMDIChildProcO. It will return an 
HTxxx code. If the code is HTCLIENT, return HTMENU instead; 
otherwise, return the unaltered HTxxx code. The code in 
mdiclick.c (Listing 1) implements this approach in a func¬ 
tion that can be called from the MM_NCHITTEST case of your 
child MDI window procedure: 

case WMJCHITTEST: 

return LwHandleHitTest(hwnd, hwndClient, wParam, IParam); 

On to your second question. The problem is that you 
are using the US_OVERLAPPED style for your synthetic dialogs. 
If you use the MS_P0PUP style and supply an owner window 
via the hwndParent parameter to CreateMindowO, only the 
owner window will show up in the task list. This style has 
other useful properties for dialog boxes as well. MS_P0PUP 
windows are (un)hidden when their owner is, and are al¬ 
ways placed above their owner in the z order. 

The CreateRoundRectRgnO problem is definitely a bug in 
GDI. I wrote a test application to reproduce it, and ran it 
under the debugger. A stack trace showed that CreateRoun¬ 
dRectRgnO was dying inside an internal helper function. 
The helper function indirects through a pointer to a data 
structure to access the member at offset 0x0022. This in 
turn is a pointer to another data structure, which is used 
later on in the function. But in the error case the first 
pointer is NULL, and as a result the helper function ends up 
accessing the string 'Invalid TrueType Font Detected' in¬ 
stead of the nested data structure! All I can suggest is to 
put a wrapper function around CreateRoundRectRgnO that 
first checks that the rectangle is not empty. 

Q I am trying to create a top-level window based on 
the predefined "edit" class. Even though I explicitly 
specify the MS_OVERLAPPEDUINDOU style in the call to 
CreateMindowO, the resulting window does not have a cap¬ 
tion bar. Also, I have found that destroying the window 
does not terminate the application. Why am I experienc¬ 
ing both of these problems? 

Ron Burk 
CIS: 70302,2566 
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A Your first problem is due to Windows' implementa¬ 
tion of the edit window class. The problem stems 
from the definition of what "window text' is. For a vanilla 
window, with a caption, the window text is the text that 
appears in its caption bar. But for predefined classes, such 
as "edit' or "static', window text is the text that appears 
inside the client area of the window. 

If you were able to create an edit or static window pos¬ 
sessing a caption bar, you would not be able to set the 
text of the caption bar with normal use of the Windows 
API. SetMndowTextO would end up setting the interior text 
instead. The Windows API was not designed to distinguish 
between the interior text of a "static" or 'edit' window and 
a captioned window's caption bar 
text. In fact, during the creation of an 
"edit' window, the edit window pro¬ 
cedure (which is private to Windows), 
checks to see if the window contains 
the MS_CAPTION style, and, if so, re¬ 
moves it. 

If you really want to, you can get 
around this behavior. The edit re¬ 
moves the US_CAPTION style during its 
processing of the UM_NCCREATE mes¬ 
sage. You can create your own class 
based on "edit" by, first, using Get- 
ClassInfoO to fill a mCLASS data 
structure; second, replacing the 
lpfnhlndProc, hlnstance, and lpszClass- 
Name members with your own values; 
and, third, registering the new class. 

You need to save away the original 
window procedure address so that 
you can call it to provide default 
processing for messages your win¬ 
dow procedure does not handle. 

Your window procedure will now get 
the first crack at the MM_NCCREATE mes¬ 
sage. If you first pass it to the edit's 
original window procedure (using 
CallMindowProcO), you can then re¬ 
store the MS_B0RDER style in the win¬ 
dow using SetWindowLongO and the 
GUL_STYLE constant. When the edit 
window is finally displayed, it will 
have a caption. 

I would advise against the above 
approach for a couple of reasons. 

The first reason is that you are still 
faced with setting the caption text. 

You can accomplish this by calling 
DefUindouProcO for the edit window, 
using the WM_SETTEXT message, and 
supplying the desired string for the 
caption bar, but this is a kludge. The 
second reason is that the edit control 
does not expect to be created with 
the US_CAPTION style, and it computes 
its default formatting rectangle based 


on this assumption. So you have to manually reset the 
formatting rectangle to the client area. Clearly, this ap¬ 
proach goes against the grain of the Windows API, but 
there is a much better solution that does not. 

It's obvious that edit and static windows are designed 
to be created as child windows. If you create a top-level 
window whose only job is to be the parent of a child edit 
window, you don't have to resort to kludges. When the 
top-level window receives a UM_CREATE message, it can cre¬ 
ate an edit control, and when it receives a UM_SIZE mes¬ 
sage, it should resize the edit control to fill the top-level 
window's client area, caption.c (Listing 2) contains the 
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code for a demo program that implements this latter ap¬ 
proach. 

The problem with your application not terminating is 
that the edit window procedure will not post a UM_QUIT 
message to the application when it is destroyed. In fact, 
none of Windows' built-in window procedures will do this. 
The onus is on the application to know when it should 
terminate itself. If you think about it, this makes a lot of 
sense, since if the edit window were a control in a dialog, 
it would be pretty nasty for termination of the dialog to 
bring down your entire application! This means that if you 
want destruction of your main window to terminate your 
application (the usual interface), then you need to explic¬ 
itly handle the UM_DESTROY message so that you can call 
PostQuitMessageO. I added a WM_DESTROY case to the top- 
level window procedure, LwUndProcO, in caption.c (Listing 
2) to do just that. 


Q l have a dialog box consisting of just static text and 
pushbuttons. Under some circumstances, when 
showing the dialog box, I want to set the focus to a push¬ 
button other than the 'OK' button. I can successfully set 
the focus to another button by using SetFocusO and re¬ 
turning FALSE to the UM_INITDIALOG message, as I can see 
the dotted outline around the text of the button I have set 
the focus to. However, if I hit the Enter key from here, the 
action that takes place is as if I had clicked on the first 
button in the tab order, rather than the button that has 
the focus. 

Any idea why this would be happening? I tried chang¬ 
ing the tab order of the pushbuttons, and I found that 
whichever button is first in the order gets executed if I hit 
Enter when the dialog appears, regardless of which button 
has the focus. What do I have to do to get the Enter key 
to execute the button that has the focus? 

Nick Payne 
CIS: 100033,432 


Listing 2 Making a top-level edit control window 


/**★★*★**★★**★***★★*★★★★*★*★★*★★★**★★**★******★★***★**/ 

{ 

/* caption.c */ 

ShowWindow(hwnd, wShow); 

/* -- Implements a captioned edit control using a */ 

while (GetMessage(&msg, NULL, 0, 0)) 

/* top level and child window. */ 

{ 

/★★★★★★★★★★★★★★★★a************************************/ 

TranslateMessage(&msg); 

#include <windows.h> 

DispatchMessage(Smsg); 

#include <windowsx.h> 

} 

} 

return msg.wParam; 

} 

LRESULT CALLBACK _export LwWndProc ( HWND hwnd, UINT wm, 

WPARAM wParam, LPARAM IParam) 

LRESULT CALLBACK _export LwWndProc(HWND hwnd, UINT wm, 

WPARAM wParam, LPARAM IParam); 

char szClasst] = "Caption2"; // Class name. 

Yfdefine cidEdit 1000 // Edit’s control ID. 

int PASCAL WinMainCHINSTANCE hins. HINSTANCE hinsPrev, 

j *★★*★**★*★★★**★*★★********★★*★*★★★*★***★**★*****★*★*★ i 

/* -- Main window procedure. */ 

LPSTR lpsz, int wShow) 

l*************1ek*****i'*******************************i'l 

/★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★A************ / 

{ 

/* -- Entry point. */ 

switch (wm) 

1*****************************************************/ 

{ 

{ 

default; 

HWND hwnd; 

break; 

MSG msg; 

WNDCLASS wcs; 

case WM CREATE: 

if (NULL =? hinsPrev) 

if (NULL == CreateWindowCedit", 

"this is some text", WS VISIBLE 1 WS CHILD I 

{ 

WS HSCROLL 1 WS VSCROLL 1 ES MULTILINE, 

wcs.style = CS HREDRAW I CS VREDRAW; 

0, 0. 0. 0, hwnd, (HMENU)cidEdit, 

wcs.lpfnWndProc = LwWndProc; 

GetWindowInstance(hwnd), NULL)) 

wcs.cbClsExtra = 0; 

return -1; 

wcs.cbWndExtra = 0; 

break; 

wcs.hlnstance = hins; 

wcs.hlcon = LoadlconCNULL, IDI APPLICATION); 

case WMJ5IZE: 

wcs.hCursor = LoadCursortNULL, IDC ARROW); 

SetWindowPos ( GetDlgltem(hwnd, cidEdit), NULL, 

wcs.hbrBackground = ( HBRUSH )( COLOR WINDOW + 1); 

0, 0, LOWORDtIParam), HIW0RD(IParam), 

wcs.lpszMenuName = NULL; 

SWPJOACTIVATE I SWPJOMOVE | SWPJOZORDER); 

wcs.lpszClassName = szClass; 

break; 

if (! RegisterClass(&wcs )) 
return FALSE; 

case WM DESTROY: 

} 

PostQuitMessage( 0) ; 

msg.wParam = 0; 

break; 

} 

if (NULL != (hwnd = CreateWindowtszClass, 

"Hi there!", WS OVERLAPPEDWINDOW, CW USEDEFAULT, 

return DefWindowProc(hwnd, wm, wParam, IParam); 

CW USEDEFAULT, CW USEDEFAULT, CW USEDEFAULT, 

) 

NULL, NULL, hins, NULL))) 

/* End of File */ 
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A The reason pressing the Enter key is activating the 
wrong button is that Enter is activating the default 
pushbutton, not the control with the focus. Your problem 
is that your dialog comes up with the focus on a pushbut¬ 
ton that is not the default pushbutton. Normally, the Win¬ 
dows dialog manager makes the pushbutton with the fo¬ 
cus the default pushbutton. I need to introduce some ter¬ 
minology to describe how the dialog manager normally 
works. 

A correct dialog template will contain at most one 
pushbutton defined using the DEFPJSHBUTTON keyword. This 
is the static default pushbutton. When the dialog manager 
makes some other pushbutton the default button, it is ma¬ 
nipulating the dynamic 'defaultness.' 

The dialog manager works like this: 

• if the user sets the focus to a pushbutton, it is made 
the dynamic default pushbutton. 

• If the user sets the focus to a non-pushbutton control, 
the defaultness is restored to the static default pushbut¬ 
ton. 

So in the second case, pressing the Enter key will acti¬ 
vate the static default pushbutton, even though some 
other control has the focus. Your situation is analogous to 
that case, except that your processing of UMJNITDIALOG has 
put the dialog in a non-standard state, since the pushbut¬ 
ton with the focus does not possess the defaultness. 


Your problem is the use of SetFocusO to set the focus 
to a pushbutton. When the user clicks on a control, or 
uses the Tab key or a keyboard mnemonic, the dialog 
manager changes the defaultness as well as the focus. But 
when you call SetFocusO directly, the dialog manager does 
not know of the focus change, so is not able to correctly 
place the defaultness. The solution is to use the 
UM_NEXTDLGCTL message. You send (or post) this message to 
the dialog itself, specifying the window handle of the con¬ 
trol to receive the focus via wParam. The dialog manager 
will then correctly change both the defaultness and the 
focus. It may be handy to encapsulate this message in a 
utility procedure: 

void SetCtlFocus(HWND hwndDlg, UINT cid) 

{ 

SendMessage(hwndDlg, WM_NEXTDLGCTL, 

(WPARAM)GetDlgItem(hwndDlg, cid), TRUE); 

} 

where hwndDlg is the dialog's window handle, and cid is 
the ID of the control to set the focus to. 
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Driver Bug of the Month 

This month's driver bug is one of my favorites: per¬ 
forming text output to a HP LaserJet II compatible mem¬ 
ory DC (device context) will cause a UAE. This occurs with 
the hppcl5a.drv driver that shipped with Windows 3.1 (ver¬ 
sion 31.3.89). You can verify this for yourself with the fol¬ 
lowing steps: 

• Get a DC for the printer using CreateDCO (call the result 
hdcl). 

• Create a compatible DC by calling CreateCompatibleDCO 
and passing in hdcl (call the result hdcfi. 

• Create a compatible bitmap for hdcl with CreateCompat- 
ibleBitmapO. 

• Select the bitmap into hdc2. 

• Write some text into hdc2 using TextOutO, DrawTextO, 
ExtTextOutO, etc. 

It turns out that the source for this driver is actually in¬ 
cluded in the DDK, in the directory \286\print- 
ers\hppcl5a\src. The bug is in the driver's exported ExtTex¬ 
tOutO function, in file physical.c. 

Each function exported by a raster driver (e.g., screen 
or printer) is passed a pointer to a driver-specific data 
structure called the 'PDEVICE'. This structure is where a 
DC s state - such as the currently selected pen, brush, or 


font - is actually maintained. But when outputting to a 
compatible DC, a "PBITMAP* is passed instead. 

The first line of the ExtTextOutO function in physical.c 
is: 

if ((!(1 pFont >dfType & TYPE_DEVICE)) && lpDevice->epTTRaster) 

The problem is that the offset to the epTTRaster field for 
this particular PDEVICE is many bytes greater than the size 
of a PBITMAP structure. Thus, when the code attempts to 
look at the epTTRaster field when a PBITMAP is being passed 
instead of a PDEVICE, it UAE's with an invalid read past the 
end of the segment containing the PBITMAP data structure. 
The bug is that the person who added the code (initials 
DTK, presumably an HP engineer) forgot to first check if 
ExtTextOutO was being called on a compatible DC. 

Fortunately, several subsequent drivers have been re¬ 
leased for this printer, none of which possess this bug. My 
main motivation for pointing out the bug is that typically 
a driver writer uses the sample drivers on the DDK as a 
starting point. So if you are writing a driver based on the 
hppcl5a.drv, be careful when you write the ExtTextOutO 
routine! □ 
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code for MSDOS, much for UNIX and other systems. Disk includes the first three text editions of the CUG Directory: indexing and describing 
every file and reviewing major packages. 
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• CICA Microsoft Windows R04 $24.95 

The entire CICA Windows Collection from Indiana University, hundreds of utilities, including shells, disk utilities, mouse and keyboard utilities, 
screen savers, backup/restore programs, performance monitors, diagnostics, data conversion programs, and games. 

• SIMTEL20 MSDOS R05 $24.95 

The entire Simtel20 MSDOS archive, 640 megabytes in 9000+ files. Many include source code, usually in C. Programming tools for APL, assembly, 
C, Pascal, Perl, Prolog, Smalltalk, etc. Communications utilities, BBS's, compression programs, shells, editors, graphics, menus, and games. 

• Garbo MSDOS/Mac R06 $24.95 

Contains the MSDOS and Mac archives from the University of Vaasa, Finland, almost all in English from Europe and America. MSDOS files are 
250 megabytes including programs for animation, archive utilities, BBS's programming tools, system utilities, business, science, education. 
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Books in Brief 

First Impressions of Recent Titles 


Ron Burk 


Undocumented DOS: A 
Programmer's Guide to 
Reserved MS-DOS Functions 
and Data Structures. 2nd 
edition. 

Andrew Schulman, Ralf Brown, 
David Maxey, Raymond J. 
Michels, and Jim Kyle 

$44.95, includes disk 
Addison-Wesley, 1994 
874 pages 
ISBN 0-201-63287-X 


Undocumented DOS served for years as the main collec¬ 
tion of reverse-engineered information about DOS (ver¬ 
sions 4 and earlier). Besides covering many undocu¬ 
mented DOS interrupt functions and internal data struc¬ 
tures, the original book touched on network redirectors, 
TSR programming, and command.com, including lots of in¬ 
formation on writing your own replacement shell. 

This long-awaited second edition has been greatly re¬ 
vised and expanded. An important change is the addition 
of material on the undocumented relationship between 
DOS and Windows - in particular, the book examines 
DOSMGR, a Windows VxD that provides the enhanced- 
mode Windows interface to DOS. Other new material in¬ 
cludes coverage of both DoubleSpace and Stacker, DOS 5 


memory management functions, a new chapter that cov¬ 
ers DR DOS (now Novell DOS), the OS/2 DOS box, the NT 
DOS box, and the NETX shell. Significant revisions include 
a completely rewritten version of INTRSPY (an included 
utility for spying on interrupts), a revised and expanded 
version of the Phantom network redirector, information 
on writing TSRs that work correctly when run in multiple 
instances of DOS under Windows, an improved DEVLOD 
(an included utility for loading device drivers from the 
command line), and an appendix revised by Ralf Brown to 
cover new undocumented functions in DOS 5 and DOS 6 
(the new appendix also fills in many data structure fields 
that were labeled 'unknown' in the first edition). Surpris¬ 
ingly, this edition even touches briefly on some aspects 
(for example, the implementation of long file names') of 
Chicago, the version of Windows that will probably not 
ship before 1995. 

Unlike most PC programming books this size, Undocu¬ 
mented DOS is dense with information, not inflated with 
code. There is plenty of source code too, but most of it 
resides on the accompanying 3.5" disk. Also unlike most 
PC programming books, Undocumented DOS thoroughly 
cites its sources - its 12-page bibliography makes interest¬ 
ing reading all by itself. If you ever find yourself having to 
write DOS or Windows programs that do something that 
Microsoft says "is not recommended," you need Undocu¬ 
mented DOS on your bookshelf. 


SECOND EDITION 


UNDOCUMENTED 


A PROGRAMMER’S GUIDE TO RESERVED 
MS-DOS FUNCTIONS AND DATA STRUCTURES 


ANDRkW,S<;HU,MAJv « RALE BROWN • DAVID MAXEY 
RAYMOND). MtCHRLS»JiM KYI* 
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DOS Internals 
Geoff Chappell 
$39.95, includes disk 
Addison-Wesley, 1994 
774 pages 
ISBN 0-201-60835-9 
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W 


It so happens that I spent a few hours with the author 
of this book in, of all places, a federal courthouse. I 
quickly formed the impression that Mr. Chappell has spent 
more time looking at DOS from inside a debugger than 
I've spent looking at DOS from the C: prompt. The visible 
result of his spelunking is this book - a sprawling discus¬ 
sion, consisting of about one-half code and tables and 
about one-half text, of how DOS (mostly versions 5 and 6, 
which the author explains are nearly indistinguishable) 
performs its tasks, such as booting, managing memory, 
handling disk I/O, using device drivers, and interacting 
with Windows. 


ATTENTION 
U.S. SUBSCRIBERS 

Correspondence with Windows/DOS Developer’s 
Journal just got easier. We mailed this issue to 
you using a self-adhesive label. 

Your account # Current Expiration 

123 January 19991 

Robert Ward t | 

R&D Publications 
1601 W. 23rd Street Ste. 200 
Lawrence, KS 66046 

’ a s 


Just peel off your address label and use it when 
corresponding with us (placing an order, submitting 
reader service cards, address changes, or any 
general correspondence). The information on this 
label will help us in responding to your needs more 
effectively. 

* Please take a moment to examine your 
name and address on the label. If 
anything needs to be changed, please 
contact us. We will correct any errors 
promptly. 

Windows/DOS Developer’s Journal 
Customer Service 

1601 W. 23rd Street Ste. 200 
Lawrence, KS 66046 USA 
VOICE 913-841-1631 
FAX 913-841-2624 
EMAIL pam@rdpub.com 


All these subjects are covered in existing books. The 
difference here is that the perspective is from inside DOS, 
not from the level of documented services. Thus, the 
multi-chapter discussion of extended memory manage¬ 
ment is less about how to use the published XMS services 
than about how XMS works and interacts with the rest of 
the system. Much of the book reads like a design discus¬ 
sion and critique; the text is speckled with descriptions of 
bugs and inadequacies within DOS itself, as well as notes 
on how well-meaning programs can go wrong due to pe¬ 
culiarities in the way DOS is implemented. Plopped in the 
middle of the book are chapters on writing TSRs and de¬ 
vice drivers in C. 

It is always difficult to organize a book about an oper¬ 
ating system because operating systems are generally col¬ 
lections of somewhat unrelated services. This book has 
not escaped that problem, and you will probably not be 
able to treat it as a reference book unless you read it 
through once to get a feel for what is covered and where. 
It is safe to say that this book is for advanced DOS pro¬ 
grammers only, but it is not just for programmers who 
might need to accomplish nefarious undocumented func¬ 
tions. For example, some years ago I had to write UNIX 
software to access a DOS partition and the description of 
low-level disk support in this book would have been a 
godsend; even though the documented information was 
enough for me to do my job, knowing more about how 
and why DOS does things would have let me build more 
robust software more quickly. 

The information content is high and the book does not 
duplicate more introductory descriptions found elsewhere. 
The book contains an 18-page index but, alas, no bibliog¬ 
raphy or reading list. If you are a programmer who writes 
software that directly interacts with DOS services, you will 
want to give this book a read. 



Windows Wisdom for C and 
C++ Programmers 
Leendert Ammeraal 
$42.95, includes 3.5" disk 
John Wiley, 1993 
245 pages. 
ISBN 0-471-94004-6 


You might think that the title Windows Wisdom is a bit 
pretentious. You would be right. Contrary to its title, this 
book is a most timid tutorial that briefly touches on a vari¬ 
ety of Windows programming topics in the least possible 
depth. The only way the book manages to achieve any 
bulk at all is by including source code in triplicate: in 
straight C, MFC, and OWL (Microsoft's and Borland's C++ 
class libraries, respectively). 
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Some examples will show what I mean by 'least possi¬ 
ble depth.' On the subject of printing, the book demon¬ 
strates how to call the Print common dialog and call Tex- 
tOutO to print a single line of text on the page (no men¬ 
tion of the problem of determining and dealing with dif¬ 
ferent printer capabilities, no mention of banding, no men¬ 
tion of how to avoid hogging the CPU during printing). An 
entire chapter is devoted to calling GetOpenFileNameO, and 
another chapter is absorbed by the task of calling the 
Choose Font common dialog and displaying text in the 
selected font. A chapter on dialog boxes for input consists 
of an edit control and a button; listboxes, comboboxes, 
checkboxes, group boxes, tab order, etc. do not arise as 
subjects of discussion. 

I struggled to find some redeeming quality in this book. 
The prose, even though it is sometimes about topics that 
are absurd for a programming book (such as how to use 
the mouse to move and close a window), is mostly quite 
clearly written. The idea of demonstrating examples in C, 
OWL, and MFC could be very useful to programmers try¬ 
ing to get the flavor of the two different application 
frameworks. Flowever, that very good idea is hobbled by 
the severe simplicity of the examples, and also by the fact 
that OWL has been rewritten since this book was created. 
I believe any beginning Windows programmer would be 
better off with either Charles Petzold's or Brent Rector's 
books on the subject. 


Windows Visualization 
Programming with C/C++: 
3D Visualization, Simulation, 
and Virtual Reality 
Lee Adams 

$39.95, includes 5.25" disk 

Windcrest (an imprint of 
McGraw-Hill, Inc.), 1994 

600 pages 

ISBN 0-8306-3812-1 



VIRTUAL REALITY 


You may have seen some other books on topics simi¬ 
lar to this one, such as Cfor Windows Animation Program¬ 
ming, by Lee Adams™, High-Performance C Graphics Pro¬ 
gramming for Windows, by Lee Adams™, High Performance 
Graphics in C: Animation and Simulation, by Lee Adams™, 
Lee Adams' Visualization Graphics in C, by Lee Adams™, Vis¬ 
ual Basic Animation Programming, by Lee Adams™, and Lee 
Adams' Supercharged C++ Graphics, by Lee Adams™. Did I 
mention that Lee Adams™ is a trademark of Lee Adams? 
In any case, this particular book promises to deliver 
toolkits (which the author estimates are worth over $800!) 
and sample applications for 3D graphics, animation, kine¬ 
matics simulation, and virtual reality. 

The book is divided into two parts: text and code (274 
pages of code). A large part of the text consists of (i know 


this sounds odd) glossary terms. For example, you will 
learn that Lambert shading is named after Johann Hein¬ 
rich Lambert, Gouraud shading is named after Henri 
Gouraud, and Phong shading is named after Bui Phong, 
but you will not find enough information in the text to 
implement any of these algorithms. Besides extensive and 
sometimes duplicated glossary terms (there's even another 
glossary in the back, in case you missed the glossary 
terms in every chapter), the text contains brief descriptions 
of the sample application and 'toolkit' code that comprise 
the rest of the book. The references are quite tedious to 
look up, since they are by line numbers and the line num¬ 
bers start over with each source file. 

The information density in this book is quite low. The 
book has a 19-page index but, sadly, out of 6 index refer¬ 
ences that I looked up, the page numbers were wrong on 
5 of them. Despite the avowed scope of the book and the 
vast literature that exists on graphics programming, the 
book contains no bibliography or reading list. The author 
was, however, able to recommend several books by Lee 
Adams™. 

I suspect the text in this book is not going to motivate 
many programmers to pay $39.95, so that leaves the 
question: how good is the code? The author gets big bo¬ 
nus points for making the code work with a variety of 
compilers (Borland, Microsoft, Watcom, and Zortech). On 
the plus side, the code is mostly broken into manageable 
functions (apart from the gargantuan switch statements 
that some Windows programmers have trouble avoiding), 
uses meaningful variable names, and is not terribly hard 
to follow if you are familiar with the Windows API. On the 
minus side, the author does not compile with -DSTRICT 
(don't expect this code to compile with Win32). Of more 
concern is the fact that the book encourages you to turn 
off those pesky compiler warnings about unused vari¬ 
ables, unreachable code, and suspicious pointer conver¬ 
sions. Finally, the use of GlobalLockO and GlobalUnlockO is 
worrisome - is this just recycled code from the bad old 
days of moveable memory, or does the author really not 
understand the rudiments of Windows memory manage¬ 
ment? 

In any case, the author's goal, $800 estimate notwith¬ 
standing, was to give you working demonstration code to 
tinker with, not commercial-quality, or ready-to-reuse 
code. To quote an apparently unintentionally humorous 
statement at the front of the book: 

Also remember that the source code is not production code 

(what developers call beta), but rather it is an advanced 

prototype code (or alpha). 

If you are getting ready to write some animation, simu¬ 
lation, 3D, or rendered graphics under Windows and you 
want to pore over hundreds of lines of someone else's 
code to get a few ideas, then this book could be just what 
you need. However, if you need to know, for example, 
what the actual algorithm for Phong shading is rather 
than just who it is named for, get a good graphics algo¬ 
rithm book like 3D Computer Graphics by Alan Watt. □ 
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New Products 

Industry-Related News & Announcements 


AFTek Ships Bug-Tracking Tool 


BugTraker is a bug-tracking and project maintenance 
tool that allows developers to keep an accurate record of 
all reported bugs. Programmers can use the software to 
view new bugs assigned to them and schedule fixes. 
Salespeople and technical support can use the system to 
determine the status of reported bugs. 

During project development, BugTraker gives project 
managers access to information such as the type of bugs 
found in the beta release, the number of unresolved 


bugs, and a schedule of when bugs are to be fixed. After 
a program is released, BugTraker helps keep track of the 
time spent maintaining the project and the type of bugs 
being reported. The program also offers querying capa¬ 
bilities for displaying graphs and printing bug reports. 

For more information, contact AFTek Software, Box 
383, Troy, NH 03465, (603)242-3876. 


ImageSoft Updates Engineering C++ Library 


Object/Engineering is a C++ class library designed for 
scientific and engineering development. Object/Engineer¬ 
ing contains three sets of classes: modeling (regressive, 
digital signal processing), numerics (random generators, 
quadratures, functions, differential equations, optimiza¬ 
tion, sorting, and statistical distributions), and founda¬ 
tions (exception handling, semi-persistent containers, 
linear algebra, and complex numbers). Each class is illus¬ 
trated with one or more sample programs. Object/Engi¬ 


neering is portable across DOS, Windows, and UNIX, and 
is integrated with a graphics package. 

Object/Engineering v3.0 costs $845 for DOS or Win¬ 
dows and $1590 for UNIX. For a limited time, the Win¬ 
dows version is available for $499 and the UNIX version 
is available for $1000. For more information, contact Im¬ 
ageSoft Incorporated, 2 Haven Avenue, Port Washington, 
NY 7 1050, (800) 245-8840 or (516) 767-2233. 


WinScope Update Captures More APIs 

WinScope is a Windows utility that allows you to 
monitor window messages and DLL calls of other Win¬ 
dows applications. WinScope vl .2 now provides auto¬ 
matic support for OLE v2.0 and Telephony API functions, 
in addition to all the DLL functions of the normal Win¬ 
dows API. A new device driver API supports Windows de¬ 
vice driver calls, such as calls made to printers, monitors, 
mice, and other add-on peripherals. A new automatic 


crash recovery feature makes sure that if the system 
crashes, the WinScope trace buffer will contain the latest 
events preceding the crash. 

WinScope vl .2 costs $149. For more information, 
contact The Periscope Company, 1475 Peachtree St, Suite 
100, Atlanta, GA 30309, (800) 722-7006 or (404) 888- 
5335; fax (404) 888-5520. 
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VGA Animate v2.0 Gets .fli Support 

VGA Animate is a set of C tools for graphics anima¬ 
tion under DOS. VGA Animate v2.0 uses the undocu¬ 
mented page-switching mode sometimes called 'Mode 
X." Mode X is available on all VGA and SVGA video 
cards. The mode provides page-flipping functions and off¬ 
screen image storage, essential for high-speed, flicker- 
free animation. The mode also provides square pixels 
and parallel pixel processing, which allows easier crea¬ 
tion of graphic elements and faster performance. 

The package contains over 130 functions for creating 
and animating images, and offers animation in 256 col¬ 
ors at 320x240 resolution. VGA Animate v2.0 includes 
PCX file format support, mouse and joystick support, font 


New VEX Provides Spelling Checking 

VisualTools, Inc. is now shipping VT-Speiler, a Visual 
Basic custom control (VBX) that provides a spelling check¬ 
ing API along with an American English dictionary of 
more than 100,000 words. Developers can control the or¬ 
der of dictionary searches, enable/disable dictionaries 
without dosing, and read out the contents of ignore/re¬ 
place lists and the custom dictionaries. Developers can 


editing capabilities, basic sound and timing functions, 
special effects functions such as dissolves and fades, pal¬ 
ette manipulation functions, and support for both Mi¬ 
crosoft and Borland C compilers. This version adds faster 
animation functions, more special effects functions, and 
the ability to read . fl i files. 

VGA Animate v2.0 costs $39, or $79 with source 
code, and is royalty-free. VGA Animate Game Developers 
Kit costs $99. For more information, contact NEXUS Soft¬ 
ware, P.O. Box 341126, Milwaukee, Wl 53234-1126, 
(414)321-6792. 


also create their own application-specific dictionaries. 
The product supports additional user-specific or foreign 
language dictionaries and can allow simultaneous multi¬ 
ple dictionaries. 

VT-Speller costs $99 and is royalty-free. For more in¬ 
formation, contact VisualTools, Inc, 15721 College Blvd., 
Lenexa, KS 66219, (800) 884-8665. 


SQL Objects++ Now Supports SQL Base, 

SQL Objects-t-r- is a C/C++ database access library de¬ 
signed to give developers a common access method to a 
number of SQL and non-SQL databases. The product sup¬ 
ports ODBC, IDAPI, an abstract SQL class interface, and di¬ 
rect database driver access. Programmers can use the 
abstract SQL class interface for portability, or issue native 
SQL statements directly to database drivers for maxi¬ 
mum performance. 

The new version now supports SQL Base, Watcom 
SQL, and ASCII files. In addition to the new drivers, SQL 


WatcomSQL 

Objects++ also supports Oracle, Sybase, SQL Server, 
DB2/d DDCS/2, Netware SQL, and Btrieve. The product 
works with Windows, OS/2, DOS, and NT; the NT and 
OS/2 versions are true 32-bit code. 

SQL Objects++ v2.0 costs from $695 to $4,995. For 
more information, contact Objects++ Software Corpora¬ 
tion, 47 Stonewall Street, Cartersville, GA 30120, (404) 
382-6585 or (800) 876-6585;fax (404) 382-6374. 


ProMath v2.0 Gains Integration, Arbitrary Precision 


TeraTech is shipping a new version of ProMath, its Ba¬ 
sic programming library of numerical routines. New rou¬ 
tines in this version include infinite integration, arbitrary 
precision math, and scatter graphing. ProMath works 
with Visual Basic for Windows, CA-Realizer, Access Basic, 
QuickBASIC, PDS v7.1, VBDOS, and Power Basic. 

ProMath v2.0 comes with 16 new numerical integra¬ 
tion routines. They can integrate over an infinite range, 
integrable singularities, and even near to non-integrable 
singularities. All the routines calculate an internal error 
estimate to ensure accurate results. The routines are an 
order of magnitude faster than older methods such as 
Simpson's rule. The 15 new arbitrary precision math rou¬ 
tines support arithmetic, trigonometric, and exponential 
functions. Numbers can be calculated to an accuracy of 
thousands of digits. The numbers are stored as strings of 


ASCII digits. A scatter graph routine has been added to 
the line graph and log graph routines. You can plot data 
points as squares, crosses, or diamonds, and use differ¬ 
ent colors for multiple data sets. 

ProMath also contains routines for FFTs, trigonomet¬ 
ric and hyperbolic functions, integration, differential equa¬ 
tions, complex functions, statistical analysis, Bessel 
functions, matrix operations, quadratic and cubic equa¬ 
tions, systems of linear and non-linear equations, and in¬ 
terpolation. Special functions include Airy, Factorial, 
Gamma, Beta, Erf, and Fresnel. 

ProMath v2.0 costs $149 and comes with full source 
code. For more information, contact TeraTedi, Inc, 100 
Park Avenue, Suite 360, Rockville, MD 20850, (800) 447- 
9120 or (301) 424-3903; fax (301) 762-8185. 


Windows/DOS Developer's Journal — Page 77 







Drag-it Brings Drag-and-Drop to Visual C++ 


Drag-it is a new Visual C++ class library and toolkit 
that allows Windows programmers to add drag-and-drop 
style graphical interfaces to Visual C++ applications. The 
package includes a class library, starter files, "Drag-it 
Builder," and a sample application. Drag-it manages all 
graphics, mouse tracking, and relationships of graphical 
components. User input is translated into Drag-it Actions 
that you can attach code to. Drag-it Builder lets you draw 


symbols (or import bitmaps) and place them on a palette. 
The product understands relations such as connected to, 
contained in, and so on. As the end user manipulates the 
diagram, the relationships are maintained. 

Drag-it costs $495. For more information, contact 
Performix, 6618 Daryn Drive, Westhills, CA91307, 

(800) 3-DRAG-ITor (818) 992-0840;fax (818) 347-9455. 


Graphics Server SDK v2.5 Includes NT and OLE 2.0 Support 


Pinnacle Publishing is shipping Graphics Server SDK 
v2.5, the latest version of its DLL for adding graphing 
and charting to Windows programs. Graphics Server SDK 
provides graphing and charting for business and scien¬ 
tific applications. Standard graph types include area 
graphs, bar graphs, pie charts, high-low-close graphs, X-Y 
graphs, polar graphs, and Gantt charts. 

The new version now comes with a 32-bit version of 
the DLL for Windows NT, at no additional cost. To create 
graphs in Windows NT, programmers call the DLL di¬ 
rectly from a C or C++ program, or use a special graph 
class for Visual C++. Graphics Server also has a new OLE 


2.0 server interface, which allows graphing capabilities 
for OLE client applications such as Microsoft Excel and 
Word. Graphics Server can be embedded in and pro¬ 
grammed by an OLE container application. This version 
also includes online Windows help files, an automatic in¬ 
stallation program, and the ability to treat a missing data 
point as a null rather than a zero. 

Graphics Server SDK v2.5 costs $299, while upgrades 
from previous versions cost $99. For more information, 
contact Pinnade Publishing, 18000 72ndAve. S„ 

Suite 217, Kent, WA 98032, (206) 251-1900; 
fax (206) 251-5057. 


VBXs Enable DCE-Compliant Windows Apps 


Gradient Technologies, Inc. is shipping Visual-DCE Ap¬ 
plication Development Toolkit for Visual Basic. Visual- 
DCE is a set of Visual Basic custom controls (VBX) 
designed to help programmers create DCE-compliant 
Windows 3.1 applications. 

Visual-DCE automatically translates remote proce¬ 
dure arguments between C and Visual Basic. No direct 
calls to any DCE API are required. The product translates 
DCE exceptions into error codes that Visual Basic can cap¬ 
ture and handle. The product is compatible with any 


VBX-compatible environment, including Visual C++ and 
Powersoft's PowerBuilder. 

Visual-DCE costs $495 and includes the Visual-DCE 
custom control VBX, the Visual-DCE IDL compiler and 
browser, sample programs, and documentation. For 
more information, contact Gradient Technologies, Inc, 5 
ML Royal Ave., Marlboro, MA 01752, (508) 624-9600; fax 
(508) 229-0338. 


Text Control Adds RTF, Hypertext Support 

TX Text Control is a DLL that lets developers add 
WYSIWYG text display, editing, and printing abilities to 
Windows applications. The product supports multiple 
fonts, font attributes, color, subscripting, and superscript¬ 
ing, all on a per-character basis, it handles tabbling, line 
spacing, and paragraph formatting. Screen text format¬ 
ting is adjusted based on the default printer to produce 
identical screen and printer formatting. You can scale TX 
windows and their contents by a factor of 10 percent to 
250 percent. Clipboard support lets you move TX data 
between the control and the clipboard. 


The new version lets you import and export RTF text, 
in addition to TX s internal format or ASCII. A new 
marked fields feature lets you add hypertext capabilities. 
Text files large than 64Kb can now be handled using a 
new linked windows enhancement. A new ruler control 
lets the user set tab stops and indents directly with the 
mouse. 

TX Text-Control v3.2 costs $1900 or $1 5,300 with 
source. 1C Image-Control costs $500, $1400 with source. 
For more information contact ESC European Software 
Connection, P.O. Box 1982, Lawrence, KS 66044. 
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Generate WinHelp Docs from Source Code with HelpBreeze 


HelpBreeze is a Windows help authoring tool that 
works with Microsoft Word to help automate the task of 
creating online Windows help files. The new version fea¬ 
tures the HelpBreeze Topic Wizard which automatically 
creates a series of help topics. You specify a list of topic ti¬ 
tles and choose a format for the topics and the Wizard 
expands this list of titles into a series of help topics and 
inserts them into the document, complete with topic ti¬ 
tles, context strings, keywords, and browse sequences. 
The Topic Wizard includes special support for automat¬ 
ically parsing source code documentation from C/C++ 
header files to produce API documentation. This version 
supports Word v6.x as well as Word v2.x. 


HelpBreeze vl .6 comes with Slide Show for WinHelp, 
a distributable DLL that can be used to add slide shows, 
sound, and bitmap animations to help files. VCR-style 
controls allow the user to control presentations directly. 
Individual slides can act as hotspots linked to hypertext 
jumps or popups, and a Windows sound file can be at¬ 
tached to each slide. 

HelpBreeze vl .6 costs $279. For more information, 
contact SolutionSoft 999 Evelyn Terrace West Suite 86, 
Sunnyvale, CA 94086, (408) 736-1431; 
fax (408) 736-4013; CompuServe 75210,2214. 


GUI Standardizer Update Features Ul Templates 


GUI Guidelines is online help software containing 
standards and references for GUI application design. The 
product helps an organization create software whose 
GUI components (menus, dialog boxes, reserved words, 
etc.) are consistent across applications. The new version 
features user interface templates; QA and developer 
checklists highlighting GUI areas that must be standards- 
compliant; application behavior standards, including tech¬ 
niques for data validation, use of multiple windows, and 
use of common templates; examples for application-spe¬ 
cific guidelines, message-bar strings, common compo¬ 


nents, and other company-specific sections; an en¬ 
hanced glossary; embedded graphics; more than 30 new 
rules and recommendations; and over 20 new figures to 
graphically illustrate standards. 

GUI Guidelines costs $8950 for 10 users, and the 
price includes two days of on-site training. An annual re¬ 
newal license is required and costs 20 percent of the pur¬ 
chase price. For more information, contact Corporate 
Computing, Inc, 2549 Waukegan Road, Suite 108, Ban¬ 
nockburn, IL 60015, (708) 374-1995;fax (708) 374-1124. 


Automatically Build Windows Screens from Database Tables 


Faces is a Windows design tool that now helps you 
automatically build Windows screens from database ta¬ 
bles. Applications built with Faces run on PCs and can 
use their own ODBC-compliant database, as well as data 
stored in host systems such as Oracle or Sybase. Develop¬ 
ers build a database table and Faces builds the screen for 
it. 

Faces also can attach directly to databases on both 
hosts and clients. It connects to data stored in any ODBC- 
compatible database, including Oracle, Sybase, and Mi¬ 


crosoft's SQL for Servers. The automatic screen builder 
can build interfaces from these data structures or add 
fields in these databases to an existing Faces user inter¬ 
face. An included DBQUERY tool lets developers create 
SQL queries to the database from a point-and-dick inter¬ 
face. 

Faces costs $995; runtime versions cost an average 
of $130 per copy. For more information, contact API In¬ 
ternational, P.O. Box 91027, Austin, TX 78709, (512) 280- 
4391; fax (512) 280-0309. 


TNT v6.1 Connects with Visual Basic 

Phar Lap has updated their TNT DOS-Extender SDK, a 
toolkit for creating 32-bit DOS-extended applications that 
work with DOS, Windows, and Windows NT. TNT applica¬ 
tions can take advantage of DLLs, threads, and multitask¬ 
ing. This new version lets developers add a Visual Basic 
front end to their DOS applications, by communicating 
with Windows via Phar Lap s WinPipe VxD (virtual de¬ 


vice driver). This version also adds support for Borland 
C++ v4.0 and Borland's Turbo Debugger. 

TNT DOS-Extender SDK v6.1 costs $495. For more in¬ 
formation, contact Phar Lap Software, Inc, 60 Aberdeen 
Avenue, Cambridge, MA 02138, (617) 661-1510;fax 
(617)876-2972. 
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Together/C++: Object Modeling for Windows C++ 


Together/C++ is an object modeling and C++ pro¬ 
gramming environment. Developers can edit in an object 
modeling window or in a C++ programming window, 
side-by-side. Together/C++ keeps the two views continu¬ 
ously synchronized. The program provides automatic, 
semi-automatic, and manual layout of object models so 
that existing class libraries can be read in and an object 
model can be immediately displayed. Object modeling 
view management allows you to view meaningful sub¬ 
sets of an overall object model. A full C++ parser catches 
syntax problems. A scripting language helps you auto¬ 


matically generate documentation by extracting object 
modeling and C++ content and automatically placing it 
in whatever format you specify. Built-in configuration 
management helps support team development. An SQL 
generation option lets you build relational tables from 
object modeling results. 

For a limited time, Together/C++ is available at an in¬ 
troductory price of $1245. For more information, contact 

Object Inti, Inc, 8140 No. MoPac Expressway 4-200, 
Austin, TX 78759-8864, (800)662-2667, or 
(512) 795-0202. 


Print Tools Offers Device-Independent Printing for C++ and BASIC 


Print Tools is a library of routines that allows develop¬ 
ers to create and print graphics and formatted text to the 
screen and a wide variety of printers (dot matrix, deskjet, 
color, plotter, laser, etc.), ail with one set of code. Print 
Tools masks the differences between and limitations of 
the output devices. With Print Tools, you can print por¬ 
trait and landscape, circles, 3D pie charts, bar charts, and 
graphs, even on an HP Series II printer at 300 dpi. You 
can create user-defined patterns and fills, as transparent 


or opaque. You can format bitmapped fonts as left, right, 
or fully justified with word wrap. PCX files such as logos 
and photos can be included in the output, and dithering 
techniques allow you to create many colors. 

Print Tools costs $350 and comes with source code 
written in BASIC or C/C++. For more information, contact 
BYTECH Business Systems, Inc, 5C Medical Park Drive, Po¬ 
mona, NY 10970, (914) 354-8666. 


Metron Ships Fast FFT Library 

METRON Engineering, Inc. has created OPTFFT, an op¬ 
timized Fast Fourier Transform (FFT) library for DOS PC 
applications. The library uses assembly language and 
new optimization methods to calculate an FFT in less 
time than standard C algorithms permit. OPTFFT takes 
the forward or inverse FFT of real or complex data (4, 8, 

1 6, 32,..., or 4096 points). The package includes an ob¬ 


ject file that programmers can link with C or C++ pro¬ 
grams, a sample C program that illustrates data input 
and output, and a standalone executable FFT program. 

OPTFFT costs $99 plus $5 shipping and handling. For 
more information, contact METRON Engineering Inc, P.O. 
Box 14395, Huntsville, AL 35815, (205) 650-5250; Com¬ 
puServe 76300,3441. 


MicroEdge Adds Features to Visual SlickEdit 


MicroEdge, Inc. has released vl .5 of Visual SlickEdit, a 
configurable graphical programmer's editor with an ob¬ 
ject-oriented C-style macro language and a built-in dialog 
editor. The new version includes color coding that sup¬ 
ports current line, modified lines, language-specific high¬ 
lighting or any combination of the three; a new menu 
editor that determines key bindings on the fly and auto¬ 
matically grays/disables menu items; and improved pro¬ 
ject management support that allows for adding files to 


a project, building a tag file for files in the project, auto re¬ 
store, and opening files in the project. Like the earlier ver¬ 
sion, SlickEdit vl .5 ships with Brief and Emacs 
emulations. 

Visual SlickEdit vl .5 costs $295. It is available for Win¬ 
dows NT on Intel, MIPS, and Alpha AXP machines, as 
well as for Windows 3.1. For more information, contact 

MicroEdge Inc, P.O. Box 18038, Raleigh, NC27619, (919) 
790-1691 or (800) 934-EDIT; fax (919) 872-5586. 


NeoPoint Ships New Release of Doughboy Professional Install 


NeoPoint Technologies is shipping v2.0 of Doughboy 
Professional Install, an installation program generator 
and disk set builder for Windows 3.x. Features retained 
from vl .0 include data compression, CRC-32 checksum¬ 
ming for data integrity, the ability to split large files over 
multiple disks, automatic creation of Program Manager 
groups and items, display of a graphic logo during instal¬ 
lation, automatic display of re a dme .txt, end-user sys¬ 
tem configuration checking and command-line 
parameter passing for run-time engines. 

New features with v2.0 include, among others, en¬ 
hanced system checking for screen resolution and color 
depth, file redirection to the Windows, System, or other 


directory, prefixes for Program Manager Group items, 
longer icon and group descriptions, a moveable status 
box, and English and French language versions of the in¬ 
stallation program. 

Doughboy Professional Install v2.0 costs $149US and 
includes a royalty-free license to distribute the disk sets 
created by Doughboy Professional Install. Upgrades from 
previous versions of Doughboy Professional Install cost 
$35US, while upgrades from previous versions of Dough¬ 
boy Install (Standard Edition) cost $1OOUS. For more infor¬ 
mation, contact NeoPoint Technologies, P.O. Box 2281, 
Winnipeg, MB, Canada R3C4A6, (204) 668-8180; fax 
(204)661-6904. 
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Readers' Forum 


To: ronb@rdpub.com 

Subject: BC++ 4.0 license agreement 

After reading Lou Grinzo's letter in the 2/94 issue of 
Windows/DOS Developer's Journal, I rechecked my license 
agreement for Borland C++ 4.0. Apparently, the licensing 
flap has been resolved, since neither the license agree¬ 
ment I have nor the additional license terms for develop¬ 
ment products contain the language you quoted. The 
terms stated are entirely reasonable and in the spirit of 
the original no-nonsense license. I suspect that, after this 
flap, Borland will not be eager to have a repeat. 

Now, if we can just convince them that a professional 
development package without an assembler and profiler 
is a dumb idea, and that not every programmer likes to 
do simple character-based editing in the bloated graphics¬ 
mode Windows environment. 

Todd Knarr 
tknarr@netcom.com 

One of the great things about Borland's C compilers was the 
fact that they came with a good assembler: TASM. However, 
Microsoft has kept assembler separately priced for years and Sy¬ 
mantec does not have an assembler to sell at all. This explains 
why I try to stick to inline assembly these days - I can get it to 
work with all three compilers, whether or not readers have a full 
assembler. I agree it would be nice if the compilers came with 
complete assemblers, but I suspect those days will not return un¬ 
less they can manage to get the street price of compilers back 
up above $200. 

I would also like to get a profiler with my compiler, but that 
seems to have gone out of style as well. Microsoft includes a 
profiler, but I gave up on using it after an hour of reading the 
sketchy documentation and trying to decipher the many utilities 
and batch files needed to run them (visual, this profiler ain't!). 
In this case, I guess I would rather pay extra money and get a 
quality product. Unfortunately, as far as I know, no one makes 
a professional source code profiler for Windows. I hope that 
does not mean that there simply aren't enough Windows pro¬ 
grammers interested in optimizing their code or doing test cov¬ 
erage analysis to justify building such a tool, -rib 


Ron, 

As one of W/DDJ's subscribers, I've got to open by say¬ 
ing keep up the good work. I teach Windows program¬ 


ming at a local university, and one of the things I stress to 
the kids is to subscribe to your pub; they can't get better 
information on advanced techniques. Got a question for 
you, though. In your most recent editorial, you say "Sym¬ 
metric multiprocessing (real SMP, not OS/2's version), port¬ 
ability, and the high-end 0/S features will pay off in the 
end for NT." I was hoping you could help educate me a 
bit. I don't know all that much about OS/2, but what ex¬ 
actly is their version of SMP, and how does it differ from 
'real' SMP? If it's too detailed to go into, could you point 
out a reference? Thanks for taking the time to help. And 
again, keep up the fine magazine. May not be slick and 
ultra-colorful, but it's substance rather than packaging that 
matters to me. 

Michael Sawczyn 
173252,2562] 

I'm not an operating systems expert, but I'll give you my two 
bits on the current multi-processing scene. Making an operating 
system support multiple processors is roughly similar to making 
one of your own applications be multithreaded - you have to 
find all the places in your code where things could go wrong if 
two copies of the code were running at the same time. Got a 
global variable that you want to increment and then compare 
to zero? What if another processor gets control after you incre¬ 
ment it but before you compare it to zero, and modifies that 
variable? You better change all the code that accesses that 
global variable to first acquire a lock, then read or modify the 
variable, then release the lock. 

It is much easier to make an operating system reentrant if 
you designed it that way from scratch. NT was designed that 
way from scratch, while OS/2 was definitely not. The odds are 
not good that you could find and fix every possible reentrancy 
problem in OS/2 (some of the attempts to make UNIX multi¬ 
processing provide a useful history lesson). However, one thing 
you could do with a fair chance of success is simply lock access 
to the operating system itself, which is my understanding of 
how OS/2 supports multiprocessing. That means that if process 
A starts a file I/O immediately before process B starts a file I/O, 
then process B must sit and wait for process A s call to the oper¬ 
ating system to complete. 

Apple's projected solution is worse than 05/2's. My under¬ 
standing is that they plan to allow you to dedicate particular 
processes to particular processors. All this is in contrast to NT, in 
which both system code and user code can execute on any 
processor in the system at any time. I expect the differences in 
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the granularity of multiprocessing of these three systems will be 
more apparent as more multiprocessing machines become ap¬ 
parent. I also expect that Apple and IBM will try to make their 
operating systems offer finer grain multiprocessing with incre¬ 
mental improvements, but I bet that the operating system with 
the fewest multiprocessing bugs (and most efficient processer 
utilization) will remain the one that was designed that way from 
scratch, -rib 


eliminate most of the sample files that are distributed with 
each new compiler release (and SDK) from your hard 
drive; and that extra bookshelf space you now have since 
moving all those SDK manuals to the attic. 

Thanks again, 

Tom Coates 
President 
AppsWare 


Dear Ron: 

I just received the Windows/DOS Developer's Journal and 
wanted to thank you for being at least one editor who 
sees the potential an operating system like Windows NT 
has. We are currently implementing an automation con¬ 
trol system under Windows NT and it is surely one of the 
best operating systems to use for such an application. 

PS: Do you plan to publish a CD-ROM with articles from 
Windows/DOS and C Users Journal in the near future? 

Sam Maczat [70034,456] 

Everybody wants W/DDJ on CD-ROM - read on... 


Dear Editor: 

I've been a subscriber for a few years. I have a small 
shareware business and make frequent use of information 
I gather from your magazine. I would like to take this op¬ 
portunity to express my appreciation for the WDDJ.HLP 
index I discovered in the CompuServe R&D forum. I'm not 
sure who should receive the credit so I am forwarding 
these comments to you in hopes that the appropriate indi¬ 
viduals) will be thanked for me. I did not notice it before 
nor did I see any reference to it in past issues. I am very 
pleased with this approach and method of archiving issue 
indexes and references. 

Along the same lines, has R&D considered providing 
back issues and program listings on CD-ROM? I exten¬ 
sively use Microsoft's "Developers' Network' CD-ROM. I be¬ 
lieve most software developers now have CD-ROM drives 
or are considering purchasing one in light of the fact that 
Windows documentation and reference have become so 
large and cumbersome that hard copy is just about use¬ 
less. Then add to that: the ability to cut and paste source 
from the CD-ROM right into your program; the ability to 


Most aspects of this magazine are very much a team effort, 
but in this case, I have to admit that the person who should 
receive credit is me, me, me! On the other hand, I also get credit 
for the fact that wddj.hlp gets updated somewhat irregularly; it 
usually happens when I have a little free time and feel guilty 
about how long it's been since it was last updated. For anyone 
who does not know what we are talking about, download win- 
dex.zip from Library 7 (R8D Publications) in forum CLMFORUM 
on CompuServe. This has a Windows help file that provides a 
cross reference of our back issues. As you point out, we need to 
do a better job of letting people know this exists. 

As for CD-ROM, we are definitely interested in doing this, but 
we don't have anything concrete to announce at the moment. 
We are already available on Ziff-Davis'"Computer Select," but 
that is somewhat pricey and does not include articles' source 
code (one of the most important features of our magazine). 
Unfortunately, getting past issues onto CD-ROM turns out to be 
non-trivia! for a variety of mundane reasons. I agree with you 
about the importance of a CD-ROM archive, though, and we 
will certainly let readers know when we have something along 
those lines to offer, -rib 


From: Andy Voelkel andyv@bionics.tele.com 
To: wdletter@rdpub.com 
Subject: help with online services 

Dear Ron, 

I have been looking for appropriate electronic forums 
to save me time in obtaining technical information as a 
Windows developer. I am interesting in conversing with 
other Windows developers and experts, as well as obtain¬ 
ing technical support on development tools that 1 pur¬ 
chase. 

i have tried using a few internet news groups to get 
information, but this hasn't been very successful approach. 
The mechanism is awkward, the information volume is 
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huge, and the number of useful responses to inquiries is 
small. I would like to use an Internet mailing list as a fo¬ 
rum, but I am not aware of any mailing lists devoted to 
Windows programming topics. Do you know of any? If 
not, I urge you to sponsor some! 

Due to my mounting frustration in looking for a forum, 
I'm thinking about paying for an online service such as 
CompuServe. Unlike Internet, I think this would solve the 
problem of technical support for development tools, as 
most companies will provide tech support over such serv¬ 
ices. However, I'm not so confident that these services 
would have healthy programmers, forums, and I don't 
know how to choose one on this basis. Also, I can't evalu¬ 
ate the relative merits of these services (as far as pricing, 
etc.) when used for this purpose, since the only reviews 
I've read on these services focus on other aspects of op¬ 
eration. 

Do you have any useful information on these subjects? 
Do you know where I could look for this information? 
Thanks in advance for any help. 

Andy Voelkel 
andyv@bionics.tele.com 


The best place for general Windows programming informa¬ 
tion is in the WINSDK forum on CompuServe. That will prob¬ 
ably remain true so long as CompuServe is the main place that 
Microsoft provides free support. Although CompuServe is one of 
the more expensive services, many developers have com¬ 
mented that the WINSDK support is better than other Microsoft 
support options that cost thousands of dollars. 

Besides the generally excellent Microsoft support staff on 
WINSDK, you will find hundreds of other developers there dis¬ 
cussing a variety of issues. Make sure you address your technical 
questions to "All" and you will typically get a quick reply from 
one of the many Windows experts who hang out in this forum. 
Microsoft also sponsors a variety of other forums for more spe¬ 
cialized Windows programming, such as WINMM for multime¬ 
dia. Also, the Microsoft Knowledge Base (CO MSKB) serves as a 
partial remedy for Microsoft bugs and incomplete and incorrect 
documentation. It is more complete than the database on the 
MSDN CD-ROM (which is derived from MSKB). I hope to see 
you online soon! -rib 


Ron, 

I appreciate W/DDJ's excellent articles dealing with 
various aspects of Windows Help and eagerly look for- 
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AVTS, A gem of a program 
at a diamond price. 


1 2 ARIS 

V) Information-Systems 


Parkstr.2,85646 Anzing, Germany 
Phone +49-8121-45624, Fax +49-8121+ 
From the USA, call 
Phone 01149-8121-45624 
, Fax 01149-8121-45625 
L Email: CompuServe 100042,1 707 
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IMWHelp 


Window/ Help Authoring Tool 


Professional quality help files 
in 1/4 the time!! 

• Edit text directly in IMWHelp 

• Build hypertext links to: topics, 
definitions, subjects 

• Glossary automatically created 

• Bitmaps incorporated 

• Desktop publishing features 

• Print topics, help file, customized 
reports 

• Spell check, replace verify/all 

• Easily reorganize topics, subjects, 
keywords 

• Uses Microsoft Help Compiler 

Single User: $89.95 

MC & Visa accepted, Shipping additional 

Call: IMCSI (212)319-1903 

425 Madison Ave , New York, NY 10017 
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Add ZIP/UNZIP Power to your app's! 


DynaZIPcompreS’on 

Toolkit for Microsoft”Windows 


Finally there's an intelligent and easy 
way to incorporate reading dnd writing 
of industry stdndard ZIP files into your 
Windows programs, without having to 
“shell' 1 to DOS. 

DynaZIP is a high-quality ROYALTY-FREE 
set of DLLs that give you a robust API for 
reading, testing, creating, writing, and 
updating your ZIP files. Supports C/C+ + 
and VB; includes source code for a 
high-quality Windows-based ZIP shell, 
comprehensive test/diagnostic tools, 
and full documentation/help system. 
Versions available for Win3.1 and NT. 


Now only $ 249.00 w/30-day 
no-risk guarantee! 

Call today, toll free: (800) 962-2949 


Inner Media. Inc.. Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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I Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 21,000 
serious programmers in: 

Windowi/POS 

□ DEVELOPER S JOURNAL 

Call 913 - 841-1631 today for 
information about 
advertising opportunities in 

Windows/DOS Developer’s Journal. 

Advanced. Serious. 

Technical. 


I Brian Osborn - Continental Europe. 

+49 431-396895 

I Ed - East I Christine - Midwest I Edwin - West 
913-841-1622 1913-841-6733 1913-841-1626 


C and C++ DOCUMENTATION 


I AUTOMATED DOCUMENTATION ! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates 
comment-blocks for each function, listing 
the functions and identifiers used by it. 

• C-METRIC ($59)Counts path complexity, 
counts comments, code, 'C' statements. 

• C-LIST ($69) Lists and action-diagrams, 
or reformats into standard formats. 

• C-REF ($59) Creates cross-reference of 
local/global/define/parameter identifiers. 

• SPE CIAL : C-DOC ($199) All 5 programs 
integrated as DOS program (<15,000 lines) 

• NEW! C-DOC Professional ($299) 

DOS, OS/2, Windows. 3-rina binder/case. 
Processes 150,000 lines, deferred reports. 

• 30-DAY Money-back guarantee CALL NOW 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga 

ONT, Canada Voice/Fax (905)-858-4466 

L5N-4M1 Demos/BBS (905 -858-1916 


see AD INDEX for our larger ad 
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USING C++ OBJECTS WITH 
SQL RDBMS’s??? 

The Solution Isn’t Obvious, It's 

SUBTLEWARE™ FOR C++/SQL 


* Uses your C++ Class 
Definitions 

* Fully supports the C++ 
Object Model 

* Automatically generates 
SQL mapping code 

* Provides Portable Object 
Persistence across a variety 
of SQL RDBMS’s 


* Works with your existing 
RDBMS’s and tools 

* Shortens your development 
and maintenance time 

* Fits into most C++ 
environments, including 
Borland C++ and Visual 
C++ 


ANSI SQL Engine 
Introductory Price $299 



CALL 1-508-663-5584 


Subtle Software 
Inc. 


30 Day Money Back Guarantee 
Ask about availability of other 
. Database Specific Modules^ 


1 Albion Road 
Billerica, MA 01821 
FAX: 508-663-5685 


© 1994 Subtle Software, Inc SubBeware™ is a trademark of Subtle Software. Inc. 
Other product names are trademarks of their respective holders 
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IPX VBX/DLL 
NetBIOS VBX 


These custom controls allow a Visual 
Basic developer to write distributed, 
client/server applications. A separate 
Windows dynamic-link library (DLL) is 
available for IPX. 


NetBIOS $99 

It runs with • 1PX/SPX $295 
NetWare 

.IPI.Vry 

10201 W. Markham, Ste. 101 
Little Rock, Arkansas 72205 
Tel (501) 221-3600 • Fax (501) 221-7412 
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NetLicense™ 

Don't Release Without It! 

Are you losing sales to customers who purchase one copy of your 
product and allow an entire company to use it simultaneously on its 
local area network? 

With NetLicense maintaining a constant watch, your product will 
automatically prevent users thorn running illegal copies on a LAN. It 
wont prevent illicit copying, but it will prevent illicit execution. If the 
network is running on their workstation, their illegal copies of your 
software won't 

• Completely self contained. 

• Prevents violations on servers or any workstation. 

• Serializes each copy of your product 

• Tamper-resistant user registration. 

• Add to your product in less than a day. 

• Indudes example programs with source code. 

• Royalty-free object code license. ^ 

• Indudes Win16 and Win32 versions. 

Introductory Price 

$595.00 


22845 NE 8th Street Suite 314 __ 

Redmond, WA 98053-7299 // Olc/f /C (- 

Phone 206-836-0111 

FAX: 206 868 0550 /J0/C7i/0/l 
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ward to more. One area I find especially intriguing is Win- 
Help's annotation and bookmark files - intriguing be¬ 
cause of the lack of relevant documentation. 

I am scheduled to release an upgrade to a product that 
includes a large Windows Help file. The release includes 
an updated Windows Help file that contains several new 
topics. The users of this product have made extensive use 
of the annotation/bookmark features and expect their an¬ 
notations and bookmarks to remain intact after they in¬ 
stall the upgrade. However, I have discovered that my up¬ 
dated Windows Help file will cause the annotations and 
bookmarks to disappear. 

Apparently, WinHelp recognizes that the Help file has 
changed and correctly assumes that the some of the in¬ 
dexes in the annotation/bookmark files are invalid. It 
therefore disregards the established annotations/book¬ 
marks. 

Ideally, I would like to use an API that would update 
the annotation/bookmark file as the new product is in¬ 
stalled. Unfortunately, such an API does not seem to exist. 
It seems that instead I need to determine the structure of 
the files and write my own routines; however, I cannot 
find any documentation which reveals the file's structure. 


Have you encountered documentation which describes 
these files? If so, perhaps an article in WDDJ addressing 
this issue would be of interest to other readers. With the 
proliferation of Windows Help files, other developers have 
or certainly will face this same problem. 

Thanks for your consideration. 

Kevin Burrows 
kburrows@hebron.connected.com 

This is one of those limitations that most everyone one runs 
into sooner or later. Microsoft refuses to document these file for¬ 
mats (even though they wrote their own code to solve the prob¬ 
lem of preserving annotations for the MSDN CD-ROM), so any 
solution you come up with must depend on undocumented in¬ 
formation. It turns out that both annotation (.ann) and book¬ 
mark (.bmk) flies have the same overall file format as help flies 
(.hip), so the best place to start is with the two-part article on the 
help file format that ran in Andrew Schulman's column starting 
in the September 1993 issue of Dr. Dobb's Journal. Pete Davis 
wrote those columns and you can often find him hanging out in 
the WinHelp section of the WINSDKforum on CompuServe, -rib 
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Marketplace 




Bridgit is a full featured database engine that provides 
easy to use functions for creating, reading, updating 
and indexing dBase-lll-t- and Clipper files. 

With Bridgit you create your application only once...then 
convert it to Windows or DOS using either dBase-lll+ or 
Clipper files. 

Order the ultimate database engine for Visual Basic 
and Visual C++ for just $69.95. 


Unelko Corporation 

Tei:(602) 991-7272 • Fax:(602) 433-7674 


TCP/IP Tools 

Why write low-level TCP/IP code when you 
can quickly and easily incorporate 
high-level components? GCP++ lets you 
add TCP/IP protocols to your application 
without coding them yourself! 

• Rapid prototyping support 

• Windows Sockets 1.1 SDK 

• VBX and DLL interfaces 

• VT-220, TCP, UDP, TFTP & TELNET 

• VT-220 for Workgroups site licenses 

• NO ROYALTIES! 

Consulting/custom development services available. 

Tel/Fax 315.841.8106 


Dart Communications 
6 Occum Ridge Road 
Deansboro, NY 13328 


commumamons 
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for Windows 3.x 



Create High 
Performance 
Network 
Applications 
FAST! 

Now Shipping 
Version 2.03! 

60 Day Money 
Back Guarantee! 


0 Shared DLL resources 
supports multiple applications 
and instances. 

0 Full post processing support 
& notification via messages 
(wait, no-wait, and polled). 

0 Complete NCB and attached 
data buffer functions simplify 
memory management. 

0 Complete documentation and 
on-line API help reference, 

0 Control panel utility allows 
dynamic DLL configuration. 

0 WINDOWS.TXT compatibilty 
for DOS support. 

0 No royalties, full source with 
demos. Now only $129.00! 


SIGMA SOFTWARE RESEARCH 

702 Windridge Dr., Atlanta, GA 30350 

ffi TEL/FAX (404) 992-0536 

Also available at the Programmer's Connection! 
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FREE Legacy Code Report 


How to Eliminate 87% 
of C Programming Errors 
in less than 2 hours! 

This valuable report reveals secrets 
known by less than 5% of all profes¬ 
sional programmers. These little 
known but powerful techniques prev¬ 
ent almost 90% of all design and main¬ 
tenance errors with the guarantee that 
your compiled code will be virtually 
error free. Limited quantity available. 

Logic Technologies 

1 (619) 228-9653 , FAX 1 (619) 369-1185 
^6089 29 Palms Hwy. Ste 254-WD, Yucca Valley, CA 922 ®^ 
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Sound & Vision Edition 

A hypertext / hypermedia Help Database Development Kit 
with two royalty free help engines and a help compiler with a 
built in cross reference tool. The current version is 10.0. 

ONE source generates help for MANY target formats like: 
Windows, OS/2, Microsoft Multimedia Viewer, THELP, 
DESQview/X, QuickHelp, PopHelp, word processors, text 
documents with table of contents, glossary and index. 

Write Once Help Many ! 

Supports Topics, PopUps, Links, Keywords, text formats, 
navigational and structural facilities, target code insertion, 
multiple module files, automatic Pascal/C/C++ reference 
generation, exception handling, graphics, sound, groups, 
multiple file target databases, Application Launch, user 
defined link templates, auto exports creation, and more. 

Get a demo version of HLPDK from CompuServe, Internet, 
PsL and other popular catalogs and BBS's. 

Order your copy from Hyper Act, Inc. or PsL today! 


$50 


+S&H 


Hyper Act, Inc. 

P.O.Box 5517, Coralville, IA 52241 
Tel/Fax (319)351-8413 
CompuServe 76350,333 
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■om Walnut Creek CDROM 

All of these discs are Unconditionally Guaranteed! 

★ Cica MS Windows CDROM: 4000 Windows 
programs-quarterly updates! $29.95* 

★ C User Group Library CDROM: Collection 
of user supported C source code $49.95* 

★ Source Code CDROM: 650 MB of Unix & 

DOS source code $39.95 

★ Simtel MSDOS CDROM: Classic:650MB 
Shareware/Freeware for MSDOS $29.95* 

★ Hobbes OS/2 CDROM: 600 MB current 
Shareware/Freeware for OS/2 $29.95* 

★ Yggdrasil Linux CDROM: 32 bit O/S for PC 

w/ GNU & X11. Source code $49.95 

★ FreeBSD CDROM: Berkeley BSD, 32 bit 

O/S for PC, w/ GNU & XI1 $39.95 

★ Internet Info CDROM: 12,000 computer, 
network, and internet documents $39.95 

★ Giga Games CDROM: 3000 hot Games for 

MSDOS and Windows , $39.95* 

♦shareware requires separate payment to authors if found useful 

Pick up the phone and Call Now! 
1-800-786-9907 IE 5S HIM 

1-510-674-0783 - FAX 1-510-674-0821 

email: orders@cdrom.com 

4041 Pike lane, Suite D-691 Concord, CA 94520 
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SpyWorks-VB 

For Visual Basic™ - Windows 

SpyWorks-VB allows you to do virtually 
anything in Visual Basic that is possible 
using other languages such as C. It 
includes controls that easily subclass 
VB forms and controls, detect keyboard 
events, and support callback functions. 
SpyWorks includes debugging tools to 
view message and event history, detect 
API parameter errors, Browse Windows 
memory and resources, and retrieve 
information about any window, form or 
control in the system. 

SpyWorks-VB is only $129 + $5 s&h ($15 
outside U.S & Canada). Visa/MC orders 
include phone and exp. date. CA residents 
add 8.25% sales tax. Dual media - Requires 
VB2.0 

Desaw are 

5 Town & Country Village #790 

San Jose, CA 95128 

(408) 377-4770 fax:(408) 371-3530 
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Career Marketing Associates 

7100 East Belleview Avenue, Suite 102 
Englewood, CO 80111 

Today, 1993 

Dear WINDOWS DEVELOPER: 

Do you know where the best 
Windows development jobs are? I spend 
my time looking for strong 
opportunities for Windows developers 
and software engineers. I might be 
looking for someone with your 
qualifications right now. And there you 
sit in the corner reading a magazine I 
Pay attention, this is your future we 
are talking about. Currently I have 
multiple jobs requiring Windows 
experience, C++, or GUI. If you are 
thinking about a career change, 
shouldn’t you be working with a 
specialist? All fees are paid by the 
company. Write, call, fax, or 
communicate by smoke signals, I’my 
waiting to hear from you. 

Sincerely, 




Gary Patton 
303-779-8890 
FAX 303-779-8139 



Windows 
Developer Jobs 

Specialists in jobs for software 
engineers in leading edge technology. 
Windows, PM, GUI, Languages, AI, 
Mac, CASE, Video, Realtime. 
Nationwide contacts with both large 
and small companies including equity 
startups. Many of our clients develop 
and publish commercial software 
products. Managed by graduate 
engineers. Never a fee to an 
applicant. 


o 


1 - 800 - 231-5920 
Scientific Placement, Inc. 

SPI-8, Box 19949, Houston, TX 77224 (713) 496-6100 
SP1-8, Box 71, San Ramon, CA 94583 (510) 733-6168 
SPI-8, Box 4270, Johnson City, TN 37602 (615) 854-9444 
Fax: 713-496-6802 please use Fine Setting on Fax 
Email: Ascii preferred: Internet LSH@Scientific.com; 
^ompuserve: 71250,3001; Genie: D.SMALL6 ^ 
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BE SURE! 

about 

COPIES SOLD=COPIES IN USE 

Try our parallel port security device. 
Extremely easy to use in DOS and 
Windows using "C\ "C++", "Visual 
BASIC", "ACCESS", "PARADOX 
PAL", "FOX PRO". We provide 
you with all software and code 
samples for using the device FREE. 

Only $24.99 each. 

(quantity discount available) 

ROY AN SYSTEMS 

2356 18th Ave., San Francisco CA 94116 

Ph:415-664-4632 Fax:415-664-5452 

Tradem arks belong to Microsoft Corp. and Borland Int. 


40 * OPTFFT 

Optimized Fast Fourier Transform 
(FFT) Library for DOS 

♦ Object file for linking with C or 
C++ routines 

♦ Written in assembler for 2X speed 
improvement 

♦ Up to 4096 real or complex points 

♦ NO ROYALTIES 

♦ 30 day money-back guarantee 

plus $5 S & H 

Specify disk size. 
METRON Engineering, Inc. 

P.O. Box 14395 
Huntsville, AL 35815 

205-650-5250 
CIS: 76300, 3441 
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2 ADDITIONAL RS-232 PORTS 
FOR WINDOWS & OS/21 

* Two RS-232 Ports 

* 16 Bit Address decode allows 
Windows & OS/2, COM3:, 

COM4: etc. 

* Individually Selectable Address 
& Interrupt (2-5,10,11,12 & 15) 

* 16550s Standard __ 

’ FREE Technical 

Support 
' MasterCard, 

VISA, & COD 

* 30 Day Money 
Sack Guarantee 

* Part #3 Odd 
Price: $69.00 


SEALEVEL SYSTEMS. INC 

$F4I FVFI p.o. box S3o 

' *-*- Liberty, SC 29657 
COMMUNICATIONS & 1/0 g03-fi>43-4343 

FAX &03-&43-3067 



Opt-Tech Sort/Merge 


^ New-Version 5 

High performance Sort/Merge/Select 
utility. Run as a stand alone 
utility or CALL as a subroutine. 

Supports most languages and 
filetypes including Btrieve 
and dBase. Unlimited filesizes 
multiple keys and much more. 

MS-DOS, Windows $149 
OS/2, UNIX $249 

Call to order or for free info. 


Opt-Tech Data Processing 
P.O. Box 678 
Zephyr Cove, NV 89448 

(702) 588-3737 J 
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JOBS 

PM 
Mac 
Oracle 
Progress 
Windows NT 
Smalltalk 
Case 
OS/2 

Our midwest Clients are using'' 

Leading edge technology you thought 
you’d only see on the coasts. Discover the 
heartland, our quality of life and our 
commitment to technology. 

Employer Paid tees only. 

All recruiters are certified by the NAPC. 

Brad Moore, C.P.C, 

600 N. Derby Lane, Suite 200, N. Sioux Cily, SD 57049 
(605) 232-3205 Fax (605) 232-3159 
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Use with the June 1994 issue only. 

□ Please start my subscription to 
Windows/DOS Developer’s Journal 
for one year. Bill me 
$29 (U.S.); $45 (Canada/Mexico); 
or $64 (all other countries). 
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□ YES! Send me 12 issues of Windows/DOS Developer’s Journal for only $29! 

□ 2 years (24 issues) for $54 □ 3 years (36 issues) for $77 

□ Bill Me dl Visa □ MasterCard 

Number_ Exp._ 

Signature_ 
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AccuSoft is now the recognized provider of 
the highest quality imaging toolkits in the 
world. Our performance, compatibility, 
ease-of-use, service, and our AccuSoft Image 
Guarantee have earned us this distinction. 
Our libraries save you hundreds of hours of 
work and provide your application with a 
unique advantage: Guaranteed Format Support. 

Incredibly Easy To Use 

Our toolkits are so easy to use that it should 
take you less than an hour to add complete 
image import, export, conversion, display, 
printing and scanning support to your appli¬ 
cation. If you need to work at a lower level 
for special situations, we have functions for 
that, too! 

Story Behind The Guarantee 

Having offered this Guarantee for over two 
years, we have collected several thousand 
(weird, but perfectly valid) images. Now¬ 
adays we see very few problem images. If we 
do, the image is usually corrupted or invalid, 
yet we are able to provide solutions for these 
images as well. 

Guaranteed to read all raster 
images in existence in the 
supported formats. If you 
can find a valid image we 
don’t read, send it to us and 
we will make it work. 



Performance Tuned By Experts 

We at AccuSoft have an unyielding commit¬ 
ment to achieving the highest performance 
possible for all our products. This, of course, 
means that your 
products will also 
achieve greater 
performance. 


AccuSoft is the Fastest! 


Support For All Platforms 

AccuSoft has versions for all major platforms 
including DOS, 32-bit DOS, Clipper, 
Foxpro, Windows™, Visual Basic®, 
Windows NT, OS/2, Chicago, Macintosh, 
and UNIX. We can also port to other sys¬ 
tems upon request. 


Complete Compression 

All forms of compression are supported 
including JPEG, Group III, Group IV, 
Packbits, LZW, Huffman, and more. Read 
any image format, then convert to any other 
format-with only two function calls! 


Features, Features, Features 

We provide a complete set of functions for 
printing, scanning, display, image processing 
and image handling. All printers and TWAIN 
scanners are supported with simple function 
calls. The image printing engine produces 
high quality output regardless of the printer. 
The display engine provides high-speed (up 
to 50 times faster than Windows) and high 
quality display for all types of images and 


display modes. Our image processing func¬ 
tions include zoom, pan, scroll, invert, 
rotate, resize, sharpen, blur, contrast, bright¬ 
ness, palette optimization, color reduction, 
matrix convolutions and much more. 

Visual Basic® Vernons 

We have special versions for Visual Basic 
that provide all the power of the DLL in the 
form of a Custom Control. We even have 
the world’s only 32-bit VBX for Windows 
3.1. Extremely Fast! 

Pro Gold Versions 

Our Pro Gold libraries represent the most 
advanced performance and features available 
in the world. We have Pro Gold versions 
available for Windows 3.1 (no special hard¬ 
ware or drivers required), Mac, UNIX and 
others. When your application demands 
unbeatable performance, go with Pro Gold. 

Call Now To Order 

800 - 525-3577 


Risk-Free 30-day money back guarantee on all 16-bit products. 
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Nu-Mega T££Mptnu%ie & 1 
BQUNDS-CHECKfefliP^rWindoi^s 


Receives Jolt Cola Produ 


WHY JOLT? 

Every year the folks at Software Development 
magazine test the industry's leading software 
development tools to find the best in several 
categories. The winners are announced at what's 


winners are 

become an industry institution - the Software 
Development Conference. At the award 
presentation. Master of Ceremonies Larry O'Brien 
pretty much set the tone when he said, "These are 
products that you ignore at your own perile." 

We're especially proud that our automatic bug 
finding tool BOUNDS-CHECKER For Windows 
won a JOLT this year for Product Excellence. 
We thank the Jolt Award committee and the 
programming community at large. Today, 
BOUNDS-CHECKER's popularity continues to 
grow with more users than ever world-wide. 

What's most important however, is that 
BOUNDS-CHECKER was developed for one 
reason: to help programmers the world over 
produce the highest standard, bug-free 
software possible. 


Order BOUNDS-CHECKER today! 
Call (603) 889-2386 • Fax (603) 889-1135 
VISA, MASTERCARD, AMEX 


1993 

FINALIST- 


Nu-Mega 

% TECHNOLOGIES Tn 


In photo: Frank Crossman, Co-Founder and programmer 
Nu-Mega Technologies, Inc. 


You’re Not Alone. 
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